octogent
A thin orchestration dashboard over Claude Code for managing context, automation, and developer headspace. You need tentacles. 🦑
Octogent is an orchestration dashboard designed to manage multiple Claude Code AI agent sessions simultaneously with isolated context and task tracking. It addresses the challenge of running many parallel coding agents by organizing work into scoped "tentacles"—each containing dedicated context files, notes, and task lists stored as markdown. Claude Code agents can spawn child agents, delegate specific todo items, and exchange messages while the developer maintains visibility and control through a local web UI and API. The system persists agent context in files rather than relying solely on chat history, enabling more durable multi-agent workflows.
Key Features
Use Cases
- 01Coordinating parallel development work across documentation, database schema, API endpoints, and frontend simultaneously
- 02Breaking large refactoring tasks into smaller chunks assigned to separate Claude Code agents
- 03Running multi-agent coding swarms where several agents work through a shared todo list
- 04Maintaining context separation when one agent handles backend logic while another updates tests
- 05Delegating specific implementation tasks from a coordinator agent to specialized worker agents
- 06Preserving work-in-progress state and notes when switching between different codebase areas
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
octogent — FAQ
What is Octogent?+
Octogent is an orchestration dashboard that manages multiple Claude Code AI agent sessions, providing each with scoped context files, task lists, and the ability to spawn and communicate with other agents. It helps developers coordinate parallel coding work without losing track of what each agent is doing.
How do I install Octogent?+
Octogent is not yet published to npm. For local development, clone the repository, run 'pnpm install' and 'pnpm dev'. For a global CLI install from source, run 'pnpm install', 'pnpm build', then 'npm install -g .' followed by the 'octogent' command.
What are the prerequisites for running Octogent?+
You need Node.js 22 or higher, the 'claude' CLI installed for agent workflows, 'git' for worktree features, 'gh' for GitHub pull request functionality, and 'curl' for Claude hook callbacks. The system will fail to start if the Claude Code binary is not available.
Which AI clients does Octogent work with?+
Octogent currently supports Claude Code as the primary coding agent. The documentation focuses exclusively on orchestrating Claude Code sessions, though the architecture is designed to potentially support other terminal-based coding agents in the future.
Is Octogent free to use?+
Yes, Octogent is open source and available on GitHub under the hesamsheikh/octogent repository. However, you will need your own Claude Code access and any associated API keys or subscriptions required by Anthropic.
How does Octogent organize agent context?+
Octogent uses "tentacles"—folders under .octogent/tentacles/ containing CONTEXT.md for area-specific notes, todo.md for task tracking, and additional markdown files. Each tentacle provides a scoped workspace so agents don't need to reconstruct full codebase context from chat history.
How do I install octogent?+
Open the source repository on GitHub and follow its README. octogent is a agent — MCP Agents Market links you directly to the official repo.
Is octogent free?+
octogent is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.