\" add a scheduled task\r\n/schedule run run a task now\r\n/schedule remove delete a task\r\n/schedule enable/disable toggle a task\r\n/schedule results [name] show result files\r\n\r\n# Plugins\r\n/plugin list available plugins + status\r\n/plugin enable enable a plugin\r\n/plugin disable disable a plugin\r\n/plugin tools show tools a plugin provides\r\n/plugin install install a plugin\r\n\r\n# Discord\r\n/discord token save bot token\r\n/discord start connect bot (auto-reconnects on next launch)\r\n/discord stop disconnect\r\n/discord status show connection info\r\n\r\n/exit quit\r\n```\r\n\r\n**Keyboard & mouse:** `Ctrl+T` new tab · `Ctrl+W` close tab · `Shift+Tab` switch tab · `Ctrl+1-9` jump to tab · `Ctrl+R` expand/collapse the last tool or thinking block · `Esc` interrupt · `Ctrl+C` twice to quit. Type `@` to mention a file; click tabs, the `+`/`✕` buttons, suggestions, and the copy/edit/retry actions that appear when you hover a message.\r\n\r\n---\r\n\r\n## Project memory & customization\r\n\r\n- **AXION.md** — put persistent project instructions in `./AXION.md`, `./.axion/AXION.md`, or `~/.axion/AXION.md`; they're loaded into every session's system prompt.\r\n- **@file mentions** — type `@src/file.js` in any message to pin that file into context (tab-completes paths).\r\n- **Custom slash commands** — drop `.md` files in `~/.axion/commands/` or `./.axion/commands/`; `review-pr.md` becomes `/review-pr`, and `$ARGUMENTS` in the body is replaced with whatever follows the command.\r\n- **Skills** — `/skill-generator minecraft remember X, Y, Z whenever minecraft comes up` has the AI write `~/.axion/skills/minecraft.md` (frontmatter: name, description, triggers). The skill auto-injects into the system prompt whenever a trigger word appears in your message. `/skills` lists them, `/skill-delete ` removes one, or edit the `.md` directly.\r\n- **Per-project settings** — drop a `.axion-settings.json` in your project root to override global defaults for that project: `{ \"model\": \"claude\", \"mode\": \"auto\", \"theme\": \"ocean\", \"systemPrompt\": \"...\", \"thinking\": true }`. Takes priority over `.axionrc`.\r\n- **Message queueing** — type while the agent is working; messages queue and send when the turn finishes.\r\n- **Background tasks** — the agent can start dev servers/watchers with `run_command background=true` and poll them with `check_task`.\r\n\r\n---\r\n\r\n## Schedule formats\r\n\r\n```\r\n/schedule add morning-report \"daily 09:00\" Summarize my GitHub notifications\r\n/schedule add weekly-review \"weekly mon 09:00\" Review what I worked on this week\r\n/schedule add price-check \"every 30m\" Check Bitcoin price and alert if > 100k\r\n```\r\n\r\nResults are saved as markdown files in `~/.axion/schedule-results/`.\r\n\r\n---\r\n\r\n## OAuth integrations\r\n\r\nConnect services to give the agent access to them:\r\n\r\n```\r\n/oauth connect github → device flow, auto-adds GitHub MCP server\r\n/oauth connect google → opens browser, connects Drive + Calendar\r\n/oauth connect notion → paste integration token\r\n/oauth connect slack → paste bot token\r\n```\r\n\r\nTo enable OAuth, register your own apps and add credentials to `~/.axion/.env`:\r\n\r\n```\r\nAXION_GITHUB_CLIENT_ID=...\r\nAXION_GITHUB_CLIENT_SECRET=...\r\nAXION_GOOGLE_CLIENT_ID=...\r\nAXION_GOOGLE_CLIENT_SECRET=...\r\n```\r\n\r\n---\r\n\r\n## Dataset Contribution\r\n\r\nHelp improve future Axion models by sharing interesting sessions. Axion automatically suggests contributing after complex or frustrating conversations.\r\n\r\n```\r\n/contribute # share this session\r\n/contribute skip # not now\r\n/contribute optout # never ask again (run with \"off\" to re-enable)\r\n```\r\n\r\nSessions are sent to the Axion Labs collector automatically — no setup needed. If you're offline, they're saved locally in `~/.axion/donations/` and uploaded the next time Axion starts with a connection.\r\n\r\n### axion-collect (local daemon)\r\n\r\nRun a persistent local collector to capture sessions before they're uploaded:\r\n\r\n```bash\r\naxion-collect # saves to ~/.axion/dataset/ on port 47832\r\naxion-collect --port 12345 # custom port\r\naxion-collect --out ~/data # custom output directory\r\n```\r\n\r\nAxion checks for the daemon on startup and routes sessions to it first when running.\r\n\r\n---\r\n\r\n## Discord Bot\r\n\r\nChat with the Axion agent directly from Discord DMs.\r\n\r\n### Setup\r\n1. Create a bot at [discord.com/developers](https://discord.com/developers/applications)\r\n2. Enable **Message Content Intent** under Bot → Privileged Gateway Intents\r\n3. Invite the bot to your server (or DM it directly)\r\n4. Save the token: `/discord token `\r\n5. Connect: `/discord start`\r\n\r\n### How it works\r\n- DMs sent to the bot appear in the CLI labeled `[Discord: username]`\r\n- The full agent responds — file access, tools, confirmations, MCP servers\r\n- The response is sent back to Discord automatically (long replies are split)\r\n- If the agent needs permission to run a tool, it DMs you a y/n prompt\r\n- The bot shows a typing indicator while processing\r\n\r\n### Commands\r\n| Command | Description |\r\n|---|---|\r\n| `/discord token ` | Save bot token |\r\n| `/discord start` | Connect (auto-reconnects on next launch) |\r\n| `/discord stop` | Disconnect (disables auto-reconnect) |\r\n| `/discord status` | Show connection info |\r\n\r\n### Standalone daemon\r\n`axion-discord` runs a persistent bot without the TUI — useful for a server:\r\n\r\n```bash\r\naxion-discord\r\naxion-discord --model claude\r\n```\r\n\r\n---\r\n\r\n## Chrome Extension\r\n\r\n1. Open `chrome://extensions`\r\n2. Enable **Developer mode**\r\n3. Click **Load unpacked**\r\n4. Select the `extension/` folder from this repo\r\n5. Click the Axion icon or press `Alt+Shift+A`\r\n\r\nThe extension sidebar lets you ask about the current page, run browser automation, take screenshots, and chat using any supported model — no API key required if using Veil. Links in AI responses are clickable and open in a new tab.\r\n\r\n---\r\n\r\n## Web UI\r\n\r\n```\r\n/web # opens http://localhost:3000\r\n/web 8080 # custom port\r\n/web stop # stop the server\r\n```\r\n\r\nThe web UI shares the same agent session as the CLI.\r\n\r\n---\r\n\r\n## MCP Servers\r\n\r\nAxion includes a built-in MCP marketplace with 13 curated servers:\r\n\r\n```\r\n/mcp browse # see all available servers\r\n/mcp search database # filter by keyword\r\n/mcp install github # install by ID\r\n/mcp install puppeteer\r\n/mcp install postgres postgresql://user:pass@localhost/db\r\n```\r\n\r\nOr connect any MCP server manually:\r\n\r\n```\r\n/mcp add github npx -y @modelcontextprotocol/server-github\r\n/mcp add notion npx -y @modelcontextprotocol/server-notion\r\n/mcp add blender /blender connect\r\n```\r\n\r\nConfig is saved to `~/.axion/mcp.json`.\r\n\r\nAvailable marketplace IDs: `github`, `filesystem`, `fetch`, `postgres`, `sqlite`, `notion`, `slack`, `puppeteer`, `memory`, `brave-search`, `google-maps`, `sequential-thinking`, `everything`\r\n\r\n---\r\n\r\n## Axion Vision\r\n\r\nA free image understanding & OCR endpoint, hosted separately from Lumen.\r\n\r\n- Powered by **GLM-OCR** (Z.ai open-weights model, purpose-built for OCR)\r\n- Reads text in screenshots, error messages, UI mockups, diagrams\r\n- OpenAI-compatible `/v1/chat/completions` — send images as base64 `image_url` content blocks\r\n- No API key required\r\n\r\nDeploy from `axion-vision-space/app.py` to a HuggingFace Space.\r\n\r\n---\r\n\r\n## Rebuilding after edits\r\n\r\nThe CLI runs from source (no build step) — just relink:\r\n\r\n```bash\r\nnpm link # (or: npm install -g .) — update the global `axion`\r\nnode build-web.js # rebuild the web UI only if you changed it\r\n```\r\n\r\n---\r\n\r\n## Project structure\r\n\r\n```\r\naxion/\r\n├── src/\r\n│ ├── agent/ # Agent loop, tools, models, MCP, OAuth APIs\r\n│ ├── tui/ # Terminal UI (OpenTUI + React, runs under Bun)\r\n│ │ ├── launch.js # `axion` entry — re-execs the TUI under Bun, or falls back\r\n│ │ ├── main.jsx # OpenTUI entry / arg parsing\r\n│ │ └── fallback.js # plain-Node readline UI (no Bun / piped input)\r\n│ ├── ui/ # Framework-free shared logic (markdown, charts, commands…)\r\n│ ├── web/ # Web server + React web client\r\n│ ├── oauth/ # OAuth providers + flow\r\n│ ├── config.js # Models, providers, API keys\r\n│ ├── persist.js # Local storage (~/.axion/)\r\n│ ├── scheduler.js # Scheduled tasks\r\n│ ├── discord-daemon.js # axion-discord standalone bot\r\n│ └── collect-daemon.js # axion-collect local dataset daemon\r\n├── collect-worker/ # Cloudflare Worker for remote session collection\r\n├── extension/ # Chrome extension\r\n├── mcp-servers/ # Bundled MCP servers (Blender)\r\n└── build-web.js # Web UI bundler (the CLI itself needs no build)\r\n```\r\n\r\n---\r\n\r\n## Command reference\r\n\r\nType any command in the CLI. All commands start with `/`. Tab completes the command name; the suggestion box shows up to 6 matches as you type.\r\n\r\n### Models & keys\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/model ` | Switch model (e.g. `claude`, `gpt`, `lumen`, `gemini`, `groq`) |\r\n| `/models` | List all available models and custom endpoints |\r\n| `/api ` | Set an API key (`claude`, `gpt`, `groq`, `mistral`, `gemini`, `glm`, `openrouter`) |\r\n| `/axion-key ` | Save your Axion API key for Lumen access |\r\n| `/axion-key remove` | Clear your Axion API key |\r\n| `/endpoint [model] [key]` | Add a custom OpenAI-compatible endpoint |\r\n| `/thinking [on\\|off\\|]` | Toggle extended thinking (Claude only) |\r\n\r\n### Chat\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/mode ` | Switch agent mode: `ask`, `plan`, `bypass` |\r\n| `/adviser [model\\|auto\\|off]` | Set or disable the adviser model |\r\n| `/system [text\\|clear]` | Set extra system-level instructions |\r\n| `/include ` | Pin a file into context (no args = list pinned) |\r\n| `/btw ` | Quick one-off question without breaking flow |\r\n| `/retry` | Re-run the last message |\r\n| `/compare [m1,m2,...] ` | Compare two or more models side by side |\r\n| `/compare-models [m1,m2,...]` | Get or set the default models for `/compare` |\r\n| `/review` | Code review of the current git diff |\r\n| `/goal ` | Loop until the agent meets a condition |\r\n| `/compact` | Summarise and compress history to save tokens |\r\n| `/cost` | Show session token usage and estimated cost |\r\n\r\n### Files & history\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/run ` | Run a shell command and feed output to the agent |\r\n| `/include ` | Pin a file into every message |\r\n| `/undo` | Restore the last overwritten or deleted file |\r\n| `/rewind [list\\|]` | Undo the last n turns of file changes |\r\n| `/export ` | Save the current chat as a markdown file |\r\n| `/save ` | Save the current chat session |\r\n| `/resume ` | Resume a saved chat (no args = list all) |\r\n| `/search-chats ` | Search across all saved chats |\r\n| `/remove-chat ` | Delete a saved chat |\r\n| `/history ` | Search message history |\r\n| `/copy` | Copy the last AI response to the clipboard |\r\n| `/copy-block ` | Copy the Nth code block from the last response |\r\n\r\n### Skills & automation\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/skills` | List all skills (auto-activate on their trigger phrases) |\r\n| `/skill ` | Create a skill from a description |\r\n| `/skill-generator ` | AI-generate a skill `.md` file |\r\n| `/skill-delete ` | Delete a skill |\r\n| `/macro record\\|stop\\|play\\|list\\|delete` | Record and replay sequences of messages |\r\n| `/watch start\\|stop\\|show\\|clear` | Watch-and-learn — build preferences from observed behaviour |\r\n| `/schedule list\\|add\\|run\\|remove\\|enable\\|disable\\|results` | Manage scheduled AI tasks |\r\n\r\n### Memory\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/remember [text]` | Save a persistent note (no args = list all) |\r\n| `/forget ` | Remove a saved note by index |\r\n\r\n### Computer use & vision\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/computer [on\\|off]` | Toggle screen control (alias: `/cu`) |\r\n| `/cu [on\\|off]` | Shortcut for `/computer` |\r\n| `/ss [question]` | Take a screenshot and describe the screen |\r\n| `/vision ` | Set the vision model for computer use |\r\n| `/img-gen ` | Generate an image via OpenAI |\r\n| `/img-gen-model [model]` | Set or show the image generation model |\r\n| `/voice` | Record voice input — transcribed by Whisper |\r\n\r\n### Integrations\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/oauth connect\\|list\\|revoke` | Link GitHub, Google, Notion, or Slack |\r\n| `/discord token\\|start\\|stop\\|status` | Discord bot — run the agent via DM |\r\n| `/web [port\\|stop]` | Open or stop the web UI |\r\n| `/blender setup\\|connect` | Set up the Blender MCP integration |\r\n| `/mcp browse\\|search\\|install\\|toggle\\|enable\\|disable\\|remove\\|tools\\|reload` | MCP marketplace |\r\n| `/plugin ...` | Browser, Docker, GitHub, and database plugins |\r\n\r\n### Misc\r\n\r\n| Command | Description |\r\n|---|---|\r\n| `/pr [context]` | Draft a PR title and body from recent commits |\r\n| `/contribute [skip\\|optout]` | Share session as training data |\r\n| `/permissions [clear]` | List or reset always-allowed tools |\r\n| `/theme [name]` | Switch accent colour (no args = list) |\r\n| `/help` | Show all commands |\r\n| `/clear` | Clear history |\r\n| `/exit` | Quit |\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — made by [Axion Labs](https://github.com/AxionLabsAI)\r\n","readmeFilename":"README.md"}
![\"Axion](\"docs/logo.svg\"){kind=logo}
\r\n