Octomind

What it does

When your agent uses it

• The user asks to use Octomind
• Hand off features
• Long-running coding work to an external agent

Example prompts

• “/octomind”

Requirements

• A credential in OPENROUTER_API_KEY
• A credential in OCTOHUB_API_KEY
• Compatibility (from SKILL.md): Requires the octomind CLI (Linux, macOS, Windows) and model access via `octomind login` or a provider API key

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Verify readiness: terminal(command="octomind --version").
2. 2For bounded tasks, pipe the task into octomind run developer:general --format plain.
3. 3For iterative tasks, start a named --daemon session in the background and use octomind send.
4. 4Monitor long tasks with process(action="poll"|"log").
5. 5Summarize file changes, test results, and remaining risks back to the user.

What it can do on your machine

Read from SKILL.md and the folder at commit 0a01e47. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • brew
  • cargo

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • OPENROUTER_API_KEY
  • OCTOHUB_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires the octomind CLI (Linux, macOS, Windows) and model access via `octomind login` or a provider API key

  From compatibility in the SKILL.md frontmatter.

Context cost

Octomind loads about 1.6k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 554 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~59

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Muvon/octomind at commit 0a01e47, republished under its Apache-2.0 licence (© Muvon). 554 words, ~1,570 tokens.

name

octomind

description

Delegate coding to the Octomind CLI — a token-efficient, model-agnostic coding agent. Use when the user asks to use Octomind, or to hand off features, fixes, refactors, reviews, or long-running coding work to an external agent.

compatibility

Requires the octomind CLI (Linux, macOS, Windows) and model access via `octomind login` or a provider API key

license

Apache-2.0

metadata.author

Muvon

metadata.version

1.0.0

terminal(command="echo 'Add retry logic to API calls and update tests' | octomind run developer:general --format plain", workdir="~/project")

terminal(command="echo 'List the TODO items in src/' | octomind run developer:general --format jsonl", workdir="~/project")

terminal(command="echo 'Refactor the auth module' | octomind run developer:general --format plain --model openrouter:anthropic/claude-sonnet-4", workdir="~/project")

terminal(command="echo 'Implement the OAuth refresh flow' | octomind run developer:general --name oauth --daemon --format jsonl", workdir="~/project", background=true)
# Returns session_id

# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Send a follow-up to the running session
terminal(command="octomind send --name oauth 'Now add error handling for token expiry'", workdir="~/project")

# Stop
process(action="kill", session_id="<id>")

terminal(command="echo 'Continue with the remaining tests' | octomind run developer:general --name oauth --format plain", workdir="~/project")

terminal(command="echo 'Fix issue #101 and commit' | octomind run developer:general --format plain", workdir="~/.hermes/cache/scratch/issue-101", background=true)
terminal(command="echo 'Add parser regression tests and commit' | octomind run developer:general --format plain", workdir="~/.hermes/cache/scratch/issue-102", background=true)
process(action="list")

terminal(command="echo 'Respond with exactly: OCTOMIND_SMOKE_OK' | octomind run developer:general --format plain")

© Muvon, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/octomind of Muvon/octomind.

Open the folder on GitHubat commit 0a01e47