[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CV8CDTDTXFW825PCK135R2":3,"skill-same:01M7CV8CDTDTXFW825PCK135R2":162},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":54,"commitSha":55,"skillDirectory":56,"forksCount":13,"repositoryHtmlUrl":57,"repositoryHomepageUrl":6,"ownerHtmlUrl":58,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":59,"install":60,"resources":73},"01M7CV8CDTDTXFW825PCK135R2","anara-agent",null,"Use, configure, theme, extend, and orchestrate Anara Agent.","dwikanugraha13\u002FProject-Anara","dwikanugraha13","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F63535036?v=4","01M7CTBN0DG8GDNP4QZ68W8M0A","01M7CTBN10Q015JDBYJS6AJRGN",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ncategory: autonomous-ai-agents\nname: anara-agent\ndescription: \"Use, configure, theme, extend, and orchestrate Anara Agent.\"\nversion: 3.2.0\nauthor: Anara Agent + Teknium\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  anara:\n    tags: [anara, setup, configuration, multi-agent, spawning, cli, gateway, bots, bot-mode, features, themes, skins, desktop-plugins, tui-widgets, petdex, development]\n    homepage: https:\u002F\u002Fgithub.com\u002Fproject-anara\u002Fanara-agent\n    related_skills: [claude-code, codex, opencode]\n---\n\n# Anara Agent\n\nAnara Agent is an open-source AI agent framework by Project Anara that runs in your terminal, a native desktop app, messaging platforms, and IDEs. It's in the same category as Anara Coding Agent (Anthropic), Codex (OpenAI), and Project Anara — autonomous coding and task-execution agents that use tool calling to interact with your system. Anara works with any LLM provider (OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, local models, and 20+ others) and runs on Linux, macOS, Windows, and WSL.\n\nWhat makes Anara different:\n\n- **Self-improving through skills** — Anara learns from experience by saving reusable procedures as skills that load into future sessions.\n- **Persistent memory across sessions** — remembers who you are, your preferences, environment details, and lessons learned. Pluggable memory backends.\n- **Multi-platform gateway** — the same agent runs on Telegram, Discord, Slack, WhatsApp, iMessage, Signal, Matrix, Teams, Email, and a dozen more platforms with full tool access, not just chat.\n- **Many surfaces** — the same agent core drives the CLI, the Ink TUI, a native Electron desktop app, a web dashboard, and an ACP server for IDEs (VS Code \u002F Zed \u002F JetBrains).\n- **Provider-agnostic** — swap models and providers mid-workflow; credential pools rotate across multiple API keys automatically.\n- **Profiles** — run multiple independent Anara instances with isolated configs, sessions, skills, and memory.\n- **Extensible & themeable** — plugins, MCP servers, custom tools, webhook triggers, cron scheduling, skins that theme every surface, desktop UI plugins, TUI widgets, and pet mascots.\n\n**This skill is a hub.** The body covers identity, quick start, spawning\u002Forchestration, and hard invariants. Everything else lives in reference files — **load the matching reference (below) before answering**; do not answer detail questions from the body alone.\n\n**Docs:** https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002F\n\n## Scope & Verification\n\nThis skill is a concise operating guide, not the complete source of truth for every Anara feature. If a Anara feature, command, or setting is not mentioned here or in a reference, do not treat that absence as evidence that it does not exist. Check the live repository and official docs before giving a negative answer.\n\nGood verification targets, cheapest first:\n\n- **Every shipped feature, one line each: https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt.** Start here for any \"can Anara do X?\" or \"how do I do X?\" — it indexes the entire documentation set with a link to the page that answers. It is generated from the docs tree on every build, so it is never behind the product. Fetch it with `web_extract`, or `curl -s https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt` when web tools are off. The whole documentation set in one file is at `\u002Fdocs\u002Fllms-full.txt`.\n- CLI commands: `anara --help`, `anara \u003Ccommand> --help`, and `hermes_cli\u002Fmain.py`\n- Source tree: https:\u002F\u002Fgithub.com\u002Fproject-anara\u002Fanara-agent\n\nNever answer \"Anara can't do that\" from memory. Anara ships far more than this skill body describes, and the index exists so a negative answer is always checkable.\n\n## Quick Start\n\n```bash\n# Install (shell installer — bootstraps PM, Python, dependencies, and the launcher)\ncurl -fsSL https:\u002F\u002Fproject-anara.dev\u002Finstall.sh | bash\n\n# Interactive chat (default surface; set display.interface: tui to launch the Ink TUI instead)\nanara\n\n# Single query\nanara chat -q \"What is the capital of France?\"\n\n# Setup wizard  \u002F  pick model+provider  \u002F  health check\nanara setup\nanara model\nanara doctor\n\n# Other surfaces\nanara desktop                 # launch the native desktop app (alias: anara gui)\nanara dashboard               # web admin panel + embedded chat\nanara proxy                   # OpenAI-compatible local proxy backed by your OAuth provider\n```\n\n## Key Paths\n\n```\n~\u002F.anara\u002Fconfig.yaml       Main configuration (settings — never secrets)\n~\u002F.anara\u002F.env              API keys and secrets ONLY (under $ANARA_HOME if set)\n$ANARA_HOME\u002Fskills\u002F        Installed skills\n~\u002F.anara\u002Fskins\u002F            Custom themes (see references\u002Fthemes.md)\n~\u002F.anara\u002Fdesktop-plugins\u002F  Desktop app UI plugins (see references\u002Fdesktop-plugins.md)\n~\u002F.anara\u002Ftui-widgets\u002F      TUI widget apps (see references\u002Ftui-widgets.md)\n~\u002F.anara\u002Fpets\u002F             Installed pet mascots (see references\u002Fpetdex.md)\n~\u002F.anara\u002Fstate.db          Canonical session store (SQLite + FTS5)\n~\u002F.anara\u002Fsessions\u002F         Gateway routing index, request dumps, *.jsonl transcripts\n~\u002F.anara\u002Flogs\u002F             Gateway and error logs\n~\u002F.anara\u002Fauth.json         OAuth tokens and credential pools\n~\u002F.anara\u002Fanara-agent\u002F     Source code (if git-installed)\n```\n\nProfiles use `~\u002F.anara\u002Fprofiles\u002F\u003Cname>\u002F` with the same layout. When a profile is active, resolve the real home from `$ANARA_HOME` — never hardcode `~\u002F.anara`.\n\n## Routing Table — load the reference for the task\n\n| User wants... | Load |\n|---|---|\n| **Anything not listed below — \"can Anara do X?\", \"how do I set up X?\"** | **https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt** |\n| Bots that chat, run routines, or message each other; the Bots tab | docs: `\u002Fuser-guide\u002Fbot-mode` |\n| CLI commands, subcommands, flags, \"how do I run X\" | `references\u002Fcli-reference.md` |\n| In-session slash commands | `references\u002Fslash-commands.md` |\n| Provider setup, API keys, OAuth | `references\u002Fproviders-and-models.md` |\n| config.yaml sections, toolsets, voice\u002FSTT\u002FTTS | `references\u002Fconfiguration.md` |\n| AGENTS.md \u002F .anara.md \u002F CLAUDE.md project rules | `references\u002Fproject-context-files.md` |\n| Secret redaction, PII, approval modes, \"reset permissions\" | `references\u002Fsecurity-privacy.md` |\n| Delegation, cron, curator, kanban | `references\u002Fbackground-systems.md` |\n| MCP servers (add, catalog, `anara mcp`) | `references\u002Fnative-mcp.md` |\n| Webhook routes and event-driven runs | `references\u002Fwebhooks.md` |\n| A custom theme\u002Fskin (\"synthwave theme\", \"change the gold ●\") | `references\u002Fthemes.md` + `templates\u002Fskin.yaml` |\n| A desktop app UI element (pane, widget, ⌘K command, page) | `references\u002Fdesktop-plugins.md` + `templates\u002Fplugin.js` |\n| A live TUI panel or modal widget (ticker, clock, dashboard) | `references\u002Ftui-widgets.md` + `templates\u002Fclock.mjs` |\n| Pet mascots — install, select, scale, diagnose | `references\u002Fpetdex.md` |\n| Windows-specific issues (keybinds, WinError 10106, BOM) | `references\u002Fwindows-quirks.md` |\n| Debugging: voice, tools missing, gateway, aux models | `references\u002Ftroubleshooting.md` |\n| Contributing code: adding tools, slash commands, tests | `references\u002Fcontributor-guide.md` |\n| delegate_task \"capped at N\" reports | `references\u002Fdelegate-task-concurrency-diagnosis.md` |\n| \"Can app X use my Nous Portal subscription\u002FOAuth?\" | `references\u002Fportal-auth-for-third-party-apps.md` |\n| Connecting a messaging platform (Telegram, Discord, Slack, WhatsApp, …) | docs: `\u002Fuser-guide\u002Fmessaging` |\n\nThe reference list above is not the feature list — it is the set of topics that\nneed more than their docs page. For everything else Anara ships, fetch\n`llms.txt` and it maps the question to the page that answers it.\n\nTwo theming rules that hold even without loading the reference: **you apply skins yourself** (`anara config set display.skin \u003Cname>` — every surface repaints live within ~a second; don't tell the user to run `\u002Fskin`), and **to tweak one color, edit the ACTIVE skin** (`anara skin set \u003Ckey> \u003Chex>`) — never fork `default`, which drops the palette and resets the background.\n\n## Spawning Additional Anara Instances\n\nRun additional Anara processes as fully independent subprocesses — separate sessions, tools, and environments.\n\n### When to Use This vs delegate_task\n\n| | `delegate_task` | Spawning `anara` process |\n|-|-----------------|--------------------------|\n| Isolation | Separate conversation, shared process | Fully independent process |\n| Duration | Minutes (bounded by parent loop) | Hours\u002Fdays |\n| Tool access | Subset of parent's tools | Full tool access |\n| Interactive | No | Yes (PTY mode) |\n| Use case | Quick parallel subtasks | Long autonomous missions |\n\n### One-Shot Mode\n\n```\nterminal(command=\"anara chat -q 'Research GRPO papers and write summary to ~\u002Fresearch\u002Fgrpo.md'\", timeout=300)\n\n# Background for long tasks:\nterminal(command=\"anara chat -q 'Set up CI\u002FCD for ~\u002Fmyapp'\", background=true)\n```\n\n### Interactive PTY Mode (via tmux)\n\nAnara uses prompt_toolkit, which requires a real terminal. Use tmux for interactive spawning:\n\n```\n# Start\nterminal(command=\"tmux new-session -d -s agent1 -x 120 -y 40 'anara'\", timeout=10)\n\n# Wait for startup, then send a message\nterminal(command=\"sleep 8 && tmux send-keys -t agent1 'Build a FastAPI auth service' Enter\", timeout=15)\n\n# Read output\nterminal(command=\"sleep 20 && tmux capture-pane -t agent1 -p\", timeout=5)\n\n# Send follow-up\nterminal(command=\"tmux send-keys -t agent1 'Add rate limiting middleware' Enter\", timeout=5)\n\n# Exit\nterminal(command=\"tmux send-keys -t agent1 '\u002Fexit' Enter && sleep 2 && tmux kill-session -t agent1\", timeout=10)\n```\n\n### Multi-Agent Coordination\n\n```\n# Agent A: backend\nterminal(command=\"tmux new-session -d -s backend -x 120 -y 40 'anara -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t backend 'Build REST API for user management' Enter\", timeout=15)\n\n# Agent B: frontend\nterminal(command=\"tmux new-session -d -s frontend -x 120 -y 40 'anara -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t frontend 'Build React dashboard for user management' Enter\", timeout=15)\n\n# Check progress, relay context between them\nterminal(command=\"tmux capture-pane -t backend -p | tail -30\", timeout=5)\nterminal(command=\"tmux send-keys -t frontend 'Here is the API schema from the backend agent: ...' Enter\", timeout=5)\n```\n\n### Session Resume\n\n```\n# Resume most recent session\nterminal(command=\"tmux new-session -d -s resumed 'anara --continue'\", timeout=10)\n\n# Resume specific session\nterminal(command=\"tmux new-session -d -s resumed 'anara --resume 20260225_143052_a1b2c3'\", timeout=10)\n```\n\n### Tips\n\n- **Prefer `delegate_task` for quick subtasks** — less overhead than spawning a full process\n- **Use `-w` (worktree mode)** when spawning agents that edit code — prevents git conflicts\n- **Set timeouts** for one-shot mode — complex tasks can take 5-10 minutes\n- **Use `anara chat -q` for fire-and-forget** — no PTY needed\n- **Use tmux for interactive sessions** — raw PTY mode has `\\r` vs `\\n` issues with prompt_toolkit\n- **For scheduled tasks**, use the `cronjob` tool instead of spawning — handles delivery and retry\n- **\"delegate_task is capped at N\" reports** — see `references\u002Fdelegate-task-concurrency-diagnosis.md`. Three real cap paths in Anara; if none fired, the model is self-limiting and rationalising it as \"the runtime caps.\"\n- **\"Can $external_app use my Nous Portal subscription \u002F OAuth?\"** — see `references\u002Fportal-auth-for-third-party-apps.md`. Walk the user through three layers (plugin-vs-app, what Portal actually exposes, local-broker-proxy option).\n\n## Surfaces (quick orientation)\n\n- **Desktop app** (`anara desktop` \u002F `anara gui`) — native Electron app for macOS\u002FLinux\u002FWindows: streaming chat, session list, Cmd+K palette, drag-and-drop files, native notifications, per-profile remote-gateway login. Extend it with UI plugins — `references\u002Fdesktop-plugins.md`.\n- **Web dashboard** (`anara dashboard`) — full admin panel: messaging channels, MCP catalog, webhooks, memory, profile builder, plus an embedded `anara --tui` chat. Secured behind an OAuth\u002Ftoken gate.\n- **Ink TUI** (`anara --tui` or `display.interface: tui`) — terminal UI with docked widget apps — `references\u002Ftui-widgets.md`.\n- **OpenAI-compatible proxy** (`anara proxy`) — a local OpenAI API backed by whichever OAuth provider you're signed into. Point Codex CLI, Aider, Cline, or any script at it — no API key.\n\n## Hard Invariants (never violate, regardless of what you loaded)\n\n- **Never break prompt caching** — don't change past context, toolsets, or the system prompt mid-conversation. The only exception is context compression.\n- **Message role alternation** — never two assistant or two user messages in a row; only `tool` results can repeat.\n- **Secrets in `.env`, settings in `config.yaml`** — never tell a user to put a non-credential setting in `.env`.\n- **Profile-safe paths** — `get_anara_home()` in code, `$ANARA_HOME` when resolving paths in a session.\n- **Never hand-edit `config.yaml` for the user** — use `anara config set KEY VAL`; a stray indent can corrupt the file and break the live gateway.\n","# Anara Agent\n\nAnara Agent is an open-source AI agent framework by Project Anara that runs in your terminal, a native desktop app, messaging platforms, and IDEs. It's in the same category as Anara Coding Agent (Anthropic), Codex (OpenAI), and Project Anara — autonomous coding and task-execution agents that use tool calling to interact with your system. Anara works with any LLM provider (OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, local models, and 20+ others) and runs on Linux, macOS, Windows, and WSL.\n\nWhat makes Anara different:\n\n- **Self-improving through skills** — Anara learns from experience by saving reusable procedures as skills that load into future sessions.\n- **Persistent memory across sessions** — remembers who you are, your preferences, environment details, and lessons learned. Pluggable memory backends.\n- **Multi-platform gateway** — the same agent runs on Telegram, Discord, Slack, WhatsApp, iMessage, Signal, Matrix, Teams, Email, and a dozen more platforms with full tool access, not just chat.\n- **Many surfaces** — the same agent core drives the CLI, the Ink TUI, a native Electron desktop app, a web dashboard, and an ACP server for IDEs (VS Code \u002F Zed \u002F JetBrains).\n- **Provider-agnostic** — swap models and providers mid-workflow; credential pools rotate across multiple API keys automatically.\n- **Profiles** — run multiple independent Anara instances with isolated configs, sessions, skills, and memory.\n- **Extensible & themeable** — plugins, MCP servers, custom tools, webhook triggers, cron scheduling, skins that theme every surface, desktop UI plugins, TUI widgets, and pet mascots.\n\n**This skill is a hub.** The body covers identity, quick start, spawning\u002Forchestration, and hard invariants. Everything else lives in reference files — **load the matching reference (below) before answering**; do not answer detail questions from the body alone.\n\n**Docs:** https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002F\n\n## Scope & Verification\n\nThis skill is a concise operating guide, not the complete source of truth for every Anara feature. If a Anara feature, command, or setting is not mentioned here or in a reference, do not treat that absence as evidence that it does not exist. Check the live repository and official docs before giving a negative answer.\n\nGood verification targets, cheapest first:\n\n- **Every shipped feature, one line each: https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt.** Start here for any \"can Anara do X?\" or \"how do I do X?\" — it indexes the entire documentation set with a link to the page that answers. It is generated from the docs tree on every build, so it is never behind the product. Fetch it with `web_extract`, or `curl -s https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt` when web tools are off. The whole documentation set in one file is at `\u002Fdocs\u002Fllms-full.txt`.\n- CLI commands: `anara --help`, `anara \u003Ccommand> --help`, and `hermes_cli\u002Fmain.py`\n- Source tree: https:\u002F\u002Fgithub.com\u002Fproject-anara\u002Fanara-agent\n\nNever answer \"Anara can't do that\" from memory. Anara ships far more than this skill body describes, and the index exists so a negative answer is always checkable.\n\n## Quick Start\n\n```bash\n# Install (shell installer — bootstraps PM, Python, dependencies, and the launcher)\ncurl -fsSL https:\u002F\u002Fproject-anara.dev\u002Finstall.sh | bash\n\n# Interactive chat (default surface; set display.interface: tui to launch the Ink TUI instead)\nanara\n\n# Single query\nanara chat -q \"What is the capital of France?\"\n\n# Setup wizard  \u002F  pick model+provider  \u002F  health check\nanara setup\nanara model\nanara doctor\n\n# Other surfaces\nanara desktop                 # launch the native desktop app (alias: anara gui)\nanara dashboard               # web admin panel + embedded chat\nanara proxy                   # OpenAI-compatible local proxy backed by your OAuth provider\n```\n\n## Key Paths\n\n```\n~\u002F.anara\u002Fconfig.yaml       Main configuration (settings — never secrets)\n~\u002F.anara\u002F.env              API keys and secrets ONLY (under $ANARA_HOME if set)\n$ANARA_HOME\u002Fskills\u002F        Installed skills\n~\u002F.anara\u002Fskins\u002F            Custom themes (see references\u002Fthemes.md)\n~\u002F.anara\u002Fdesktop-plugins\u002F  Desktop app UI plugins (see references\u002Fdesktop-plugins.md)\n~\u002F.anara\u002Ftui-widgets\u002F      TUI widget apps (see references\u002Ftui-widgets.md)\n~\u002F.anara\u002Fpets\u002F             Installed pet mascots (see references\u002Fpetdex.md)\n~\u002F.anara\u002Fstate.db          Canonical session store (SQLite + FTS5)\n~\u002F.anara\u002Fsessions\u002F         Gateway routing index, request dumps, *.jsonl transcripts\n~\u002F.anara\u002Flogs\u002F             Gateway and error logs\n~\u002F.anara\u002Fauth.json         OAuth tokens and credential pools\n~\u002F.anara\u002Fanara-agent\u002F     Source code (if git-installed)\n```\n\nProfiles use `~\u002F.anara\u002Fprofiles\u002F\u003Cname>\u002F` with the same layout. When a profile is active, resolve the real home from `$ANARA_HOME` — never hardcode `~\u002F.anara`.\n\n## Routing Table — load the reference for the task\n\n| User wants... | Load |\n|---|---|\n| **Anything not listed below — \"can Anara do X?\", \"how do I set up X?\"** | **https:\u002F\u002Fproject-anara.dev\u002Fdocs\u002Fllms.txt** |\n| Bots that chat, run routines, or message each other; the Bots tab | docs: `\u002Fuser-guide\u002Fbot-mode` |\n| CLI commands, subcommands, flags, \"how do I run X\" | `references\u002Fcli-reference.md` |\n| In-session slash commands | `references\u002Fslash-commands.md` |\n| Provider setup, API keys, OAuth | `references\u002Fproviders-and-models.md` |\n| config.yaml sections, toolsets, voice\u002FSTT\u002FTTS | `references\u002Fconfiguration.md` |\n| AGENTS.md \u002F .anara.md \u002F CLAUDE.md project rules | `references\u002Fproject-context-files.md` |\n| Secret redaction, PII, approval modes, \"reset permissions\" | `references\u002Fsecurity-privacy.md` |\n| Delegation, cron, curator, kanban | `references\u002Fbackground-systems.md` |\n| MCP servers (add, catalog, `anara mcp`) | `references\u002Fnative-mcp.md` |\n| Webhook routes and event-driven runs | `references\u002Fwebhooks.md` |\n| A custom theme\u002Fskin (\"synthwave theme\", \"change the gold ●\") | `references\u002Fthemes.md` + `templates\u002Fskin.yaml` |\n| A desktop app UI element (pane, widget, ⌘K command, page) | `references\u002Fdesktop-plugins.md` + `templates\u002Fplugin.js` |\n| A live TUI panel or modal widget (ticker, clock, dashboard) | `references\u002Ftui-widgets.md` + `templates\u002Fclock.mjs` |\n| Pet mascots — install, select, scale, diagnose | `references\u002Fpetdex.md` |\n| Windows-specific issues (keybinds, WinError 10106, BOM) | `references\u002Fwindows-quirks.md` |\n| Debugging: voice, tools missing, gateway, aux models | `references\u002Ftroubleshooting.md` |\n| Contributing code: adding tools, slash commands, tests | `references\u002Fcontributor-guide.md` |\n| delegate_task \"capped at N\" reports | `references\u002Fdelegate-task-concurrency-diagnosis.md` |\n| \"Can app X use my Nous Portal subscription\u002FOAuth?\" | `references\u002Fportal-auth-for-third-party-apps.md` |\n| Connecting a messaging platform (Telegram, Discord, Slack, WhatsApp, …) | docs: `\u002Fuser-guide\u002Fmessaging` |\n\nThe reference list above is not the feature list — it is the set of topics that\nneed more than their docs page. For everything else Anara ships, fetch\n`llms.txt` and it maps the question to the page that answers it.\n\nTwo theming rules that hold even without loading the reference: **you apply skins yourself** (`anara config set display.skin \u003Cname>` — every surface repaints live within ~a second; don't tell the user to run `\u002Fskin`), and **to tweak one color, edit the ACTIVE skin** (`anara skin set \u003Ckey> \u003Chex>`) — never fork `default`, which drops the palette and resets the background.\n\n## Spawning Additional Anara Instances\n\nRun additional Anara processes as fully independent subprocesses — separate sessions, tools, and environments.\n\n### When to Use This vs delegate_task\n\n| | `delegate_task` | Spawning `anara` process |\n|-|-----------------|--------------------------|\n| Isolation | Separate conversation, shared process | Fully independent process |\n| Duration | Minutes (bounded by parent loop) | Hours\u002Fdays |\n| Tool access | Subset of parent's tools | Full tool access |\n| Interactive | No | Yes (PTY mode) |\n| Use case | Quick parallel subtasks | Long autonomous missions |\n\n### One-Shot Mode\n\n```\nterminal(command=\"anara chat -q 'Research GRPO papers and write summary to ~\u002Fresearch\u002Fgrpo.md'\", timeout=300)\n\n# Background for long tasks:\nterminal(command=\"anara chat -q 'Set up CI\u002FCD for ~\u002Fmyapp'\", background=true)\n```\n\n### Interactive PTY Mode (via tmux)\n\nAnara uses prompt_toolkit, which requires a real terminal. Use tmux for interactive spawning:\n\n```\n# Start\nterminal(command=\"tmux new-session -d -s agent1 -x 120 -y 40 'anara'\", timeout=10)\n\n# Wait for startup, then send a message\nterminal(command=\"sleep 8 && tmux send-keys -t agent1 'Build a FastAPI auth service' Enter\", timeout=15)\n\n# Read output\nterminal(command=\"sleep 20 && tmux capture-pane -t agent1 -p\", timeout=5)\n\n# Send follow-up\nterminal(command=\"tmux send-keys -t agent1 'Add rate limiting middleware' Enter\", timeout=5)\n\n# Exit\nterminal(command=\"tmux send-keys -t agent1 '\u002Fexit' Enter && sleep 2 && tmux kill-session -t agent1\", timeout=10)\n```\n\n### Multi-Agent Coordination\n\n```\n# Agent A: backend\nterminal(command=\"tmux new-session -d -s backend -x 120 -y 40 'anara -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t backend 'Build REST API for user management' Enter\", timeout=15)\n\n# Agent B: frontend\nterminal(command=\"tmux new-session -d -s frontend -x 120 -y 40 'anara -w'\", timeout=10)\nterminal(command=\"sleep 8 && tmux send-keys -t frontend 'Build React dashboard for user management' Enter\", timeout=15)\n\n# Check progress, relay context between them\nterminal(command=\"tmux capture-pane -t backend -p | tail -30\", timeout=5)\nterminal(command=\"tmux send-keys -t frontend 'Here is the API schema from the backend agent: ...' Enter\", timeout=5)\n```\n\n### Session Resume\n\n```\n# Resume most recent session\nterminal(command=\"tmux new-session -d -s resumed 'anara --continue'\", timeout=10)\n\n# Resume specific session\nterminal(command=\"tmux new-session -d -s resumed 'anara --resume 20260225_143052_a1b2c3'\", timeout=10)\n```\n\n### Tips\n\n- **Prefer `delegate_task` for quick subtasks** — less overhead than spawning a full process\n- **Use `-w` (worktree mode)** when spawning agents that edit code — prevents git conflicts\n- **Set timeouts** for one-shot mode — complex tasks can take 5-10 minutes\n- **Use `anara chat -q` for fire-and-forget** — no PTY needed\n- **Use tmux for interactive sessions** — raw PTY mode has `\\r` vs `\\n` issues with prompt_toolkit\n- **For scheduled tasks**, use the `cronjob` tool instead of spawning — handles delivery and retry\n- **\"delegate_task is capped at N\" reports** — see `references\u002Fdelegate-task-concurrency-diagnosis.md`. Three real cap paths in Anara; if none fired, the model is self-limiting and rationalising it as \"the runtime caps.\"\n- **\"Can $external_app use my Nous Portal subscription \u002F OAuth?\"** — see `references\u002Fportal-auth-for-third-party-apps.md`. Walk the user through three layers (plugin-vs-app, what Portal actually exposes, local-broker-proxy option).\n\n## Surfaces (quick orientation)\n\n- **Desktop app** (`anara desktop` \u002F `anara gui`) — native Electron app for macOS\u002FLinux\u002FWindows: streaming chat, session list, Cmd+K palette, drag-and-drop files, native notifications, per-profile remote-gateway login. Extend it with UI plugins — `references\u002Fdesktop-plugins.md`.\n- **Web dashboard** (`anara dashboard`) — full admin panel: messaging channels, MCP catalog, webhooks, memory, profile builder, plus an embedded `anara --tui` chat. Secured behind an OAuth\u002Ftoken gate.\n- **Ink TUI** (`anara --tui` or `display.interface: tui`) — terminal UI with docked widget apps — `references\u002Ftui-widgets.md`.\n- **OpenAI-compatible proxy** (`anara proxy`) — a local OpenAI API backed by whichever OAuth provider you're signed into. Point Codex CLI, Aider, Cline, or any script at it — no API key.\n\n## Hard Invariants (never violate, regardless of what you loaded)\n\n- **Never break prompt caching** — don't change past context, toolsets, or the system prompt mid-conversation. The only exception is context compression.\n- **Message role alternation** — never two assistant or two user messages in a row; only `tool` results can repeat.\n- **Secrets in `.env`, settings in `config.yaml`** — never tell a user to put a non-credential setting in `.env`.\n- **Profile-safe paths** — `get_anara_home()` in code, `$ANARA_HOME` when resolving paths in a session.\n- **Never hand-edit `config.yaml` for the user** — use `anara config set KEY VAL`; a stray indent can corrupt the file and break the live gateway.\n",{"name":5,"author":23,"license":14,"version":24,"category":25,"metadata":26,"platforms":50,"description":7},"Anara Agent + Teknium","3.2.0","autonomous-ai-agents",{"anara":27},{"tags":28,"homepage":45,"related_skills":46},[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"anara","setup","configuration","multi-agent","spawning","cli","gateway","bots","bot-mode","features","themes","skins","desktop-plugins","tui-widgets","petdex","development","https:\u002F\u002Fgithub.com\u002Fproject-anara\u002Fanara-agent",[47,48,49],"claude-code","codex","opencode",[51,52,53],"linux","macos","windows","main","3e6d6b7ffb6ab43ddf3991509e5cfb5f8c90cd1a","backend\u002Fskills\u002Fanara-agent","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13","2026-10-13 07:57:21",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add dwikanugraha13\u002FProject-Anara --skill anara-agent",{"tool":66,"command":67},"bunx","bunx skills add dwikanugraha13\u002FProject-Anara --skill anara-agent",{"tool":69,"command":70},"pnpm","pnpm dlx skills add dwikanugraha13\u002FProject-Anara --skill anara-agent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002FSKILL.md",true,[74,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,154,158],{"path":75,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fbackground-systems.md","REFERENCE","参考文档",5026,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fbackground-systems.md",{"path":81,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fcli-reference.md",6471,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fcli-reference.md",{"path":85,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fconfiguration.md",4393,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fconfiguration.md",{"path":89,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fcontributor-guide.md",5868,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fcontributor-guide.md",{"path":93,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Fdelegate-task-concurrency-diagnosis.md",4651,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fdelegate-task-concurrency-diagnosis.md",{"path":97,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Fdesktop-plugins.md",13057,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fdesktop-plugins.md",{"path":101,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":102,"sourceHtmlUrl":103},"references\u002Fnative-mcp.md",12566,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fnative-mcp.md",{"path":105,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002Fpetdex.md",3220,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fpetdex.md",{"path":109,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":110,"sourceHtmlUrl":111},"references\u002Fportal-auth-for-third-party-apps.md",6529,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fportal-auth-for-third-party-apps.md",{"path":113,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":114,"sourceHtmlUrl":115},"references\u002Fproject-context-files.md",3280,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fproject-context-files.md",{"path":117,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":118,"sourceHtmlUrl":119},"references\u002Fproviders-and-models.md",3360,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fproviders-and-models.md",{"path":121,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":122,"sourceHtmlUrl":123},"references\u002Fsecurity-privacy.md",3375,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fsecurity-privacy.md",{"path":125,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":126,"sourceHtmlUrl":127},"references\u002Fslash-commands.md",5377,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fslash-commands.md",{"path":129,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":130,"sourceHtmlUrl":131},"references\u002Fthemes.md",6862,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fthemes.md",{"path":133,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":134,"sourceHtmlUrl":135},"references\u002Ftroubleshooting.md",3755,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Ftroubleshooting.md",{"path":137,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":138,"sourceHtmlUrl":139},"references\u002Ftui-widgets.md",6479,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Ftui-widgets.md",{"path":141,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":142,"sourceHtmlUrl":143},"references\u002Fwebhooks.md",8422,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fwebhooks.md",{"path":145,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":146,"sourceHtmlUrl":147},"references\u002Fwindows-quirks.md",2666,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Freferences\u002Fwindows-quirks.md",{"path":149,"resourceType":150,"resourceTypeDesc":151,"sizeBytes":152,"sourceHtmlUrl":153},"templates\u002Fclock.mjs","SCRIPT","脚本",1422,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Ftemplates\u002Fclock.mjs",{"path":155,"resourceType":150,"resourceTypeDesc":151,"sizeBytes":156,"sourceHtmlUrl":157},"templates\u002Fplugin.js",3132,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Ftemplates\u002Fplugin.js",{"path":159,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":160,"sourceHtmlUrl":161},"templates\u002Fskin.yaml",1386,"https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fanara-agent\u002Ftemplates\u002Fskin.yaml",[163,170,177,185,192,199],{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":18},"01M7CVK8W5MPQ8H45A6XE6RPK1","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":174,"categories":175,"keywords":176,"publishedAt":18},"01M7CVK56KG9399ZZVE9KM54WS","xurl","X\u002FTwitter via xurl CLI: raw post search, posting, DM, media.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":181,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":18},"01M7CVK22A44A88NPPBAC1FVQP","xlsx","Create, read, edit Excel .xlsx workbooks and CSVs.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fxlsx\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fxlsx\u002FSKILL.md",[],[],{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":191,"publishedAt":18},"01M7CVJX88C8PY2T6RQZ5GCG15","weights-and-biases","W&B: log ML experiments, sweeps, model registry, dashboards.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fweights-and-biases\u002FSKILL.md",[],[],{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":198,"publishedAt":18},"01M7CVJR3W1FBRGC56DG6BJ1Y3","weekly-review-planning","Weekly reset: commitments, stalled work, next-week plan.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Fweekly-review-planning\u002FSKILL.md",[],[],{"skillNo":200,"name":201,"nameZh":6,"description":202,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":203,"categories":204,"keywords":205,"publishedAt":18},"01M7CVJGPJNPQDM8S1KTTMJN7M","touchdesigner-mcp","Control TouchDesigner via twozero MCP.","https:\u002F\u002Fgithub.com\u002Fdwikanugraha13\u002FProject-Anara\u002Fblob\u002Fmain\u002Fbackend\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[]]