# Agent-Unleashed (agt-ul) — Full Technical Specification & Knowledge Base

> Version: 1.0.0 | Pure Go Runtime | Zero CGO Dependencies | MIT Licensed

## Executive Summary
Agent-Unleashed (`agt-ul`) is a high-performance, single-binary autonomous AI agent operating system designed to multiplex local developer CLI agents into a persistent 24/7 background daemon. Unlike frameworks that rely exclusively on per-token cloud API billing (such as OpenClaw) or heavy Python execution environments (such as Hermes Agent), Agent-Unleashed runs in Pure Go with a memory footprint under 15MB RAM.

---

## Supported AI CLI Adapters
1. **Google Antigravity (`agy`)**: Invokes Google DeepMind's agentic CLI via non-interactive JSON pipes using authenticated Google OAuth credentials.
2. **Anthropic Claude Code (`claude`)**: Multiplexes Anthropic's terminal agent using local browser authentication.
3. **OpenAI Codex (`codex`)**: Executes OpenAI's terminal developer agent with zero friction.
4. **Aider (`aider`)**: Coordinates multi-file git-aware pair programming sessions.
5. **Local Ollama (`ollama`)**: Runs 100% offline inference using local weights (e.g., DeepSeek-R1, Qwen2.5-Coder).
6. **Multi-Provider API (`api`)**: Direct REST API client for Gemini, Claude, OpenAI, and OpenRouter endpoints.

---

## Cognitive Architecture
- **Palace-Mnemosyne Memory Palace:** Stores memories across Wings, Rooms, and Drawers in SQLite. Implements the Ebbinghaus forgetting decay model $R = e^{-\lambda \Delta t}$, reinforcing frequently accessed knowledge and fading transient chatter.
- **Lossless Context Management (LCM):** Uses a Directed Acyclic Graph (DAG) to store verbatim messages in `lcm_messages` while compressing history into depth-aware summary nodes. Eliminates context rot while providing `:lcm grep`, `:lcm describe`, and `:lcm expand` recovery tools.
- **Auto-Compiled LLM-Wiki:** Continuously indexes project architecture and domain models into `.agents/wiki/*.md`, injecting 1-line YAML catalog items into prompt contexts.
- **In-Process 24/7 Cron Engine:** Ingests 5-part cron expressions (`0 3 * * *`) to trigger recurring tasks dispatched via Telegram, Discord, or console.

---

## Gateways & API Endpoints
- **WebSocket Streaming:** `ws://127.0.0.1:8080/ws`
- **REST Endpoints:**
  - `GET /health` & `GET /healthz` — System health and active driver
  - `GET /api/v1/status` — Detected CLI drivers, memory, and gateway status
  - `GET /api/v1/wiki` — Compiled LLM-Wiki knowledge graph
  - `GET /api/v1/lcm` — Lossless Context Management DAG metrics
  - `POST /api/v1/chat` & `POST /api/v1/trigger` — Dispatches execution tasks to active driver
- **Telegram Bot:** Long-polling gateway with inline callback verification buttons.
- **Discord Bot:** Real-time pairing and DM assistance.

---

## Command Reference
- `agt-ul`: Launch interactive REPL and 24/7 daemon
- `agt-ul -v`: Launch in Verbose mode
- `agt-ul setup`: Run interactive configuration wizard
- `agt-ul status`: Display system diagnostics and detected tools
- `agt-ul doctor`: 10-point system audit (`--fix` to auto-repair)
- `agt-ul update`: In-place self-upgrade and recompilation
- `agt-ul wiki`: Browse compiled LLM-Wiki articles
- `agt-ul lcm`: Lossless Context Management DAG inspection
- `agt-ul cron`: List scheduled background tasks
- `agt-ul skill install <repo>`: Install skills from GitHub (e.g. `Leonxlnx/taste-skill`)

---

## Theming
Built-in ANSI TrueColor theme engine supporting 6 color palettes:
- `kinetic`: Neon Cyan & Electric Violet
- `dracula`: Soft Purple, Pink & Cyan
- `matrix`: Phosphor Green & Dark Emerald
- `catppuccin`: Mauve, Peach & Lavender
- `nord`: Arctic Frost Cyan & Glacier White
- `amber`: Vintage 1980s CRT Amber Phosphor

---

## Contact & Links
- Website: https://agent.subimpact.net
- GitHub: https://github.com/subimpact/agent-unleashed
- Sponsorship: https://buymeacoffee.com/subimpact