A coding agent for your terminal. Bring your model, work in your project, and follow every step.
简体中文 · Install · Quick start · npm
Talos helps you explore a codebase, edit files, and run commands through a terminal conversation. Replies, tool activity, and permission requests stay next to the work. Classic is the default interface; /settings can switch to Collapsal after a restart. Choose a provider preset or connect your own compatible endpoint.
Requires Node.js 22.19–22.x, 24.2–24.x, 25.x, or 26.x.
npm install -g @pakiknowledge/tal0s-code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optionalInstall scripts are needed for native dependencies. Keep optional dependencies enabled.
Open a terminal in the project you want to work on:
cd /path/to/your/project
talos- Enter
/providerto configure a model connection. Select a preset or supply your endpoint, model name, and API key. - Describe your task and the result you want. For example: “Explain how this project starts, then identify the files involved.”
- Follow the replies and tool activity. Review permission requests when prompted. In Auto,
/settingscan point those asks at your own LLM judge.
Model usage is billed by your chosen provider.
Collapsal welcome (Classic remains the default). The wallpaper and transparency are terminal settings.
| Command | Use |
|---|---|
talos "Explain this repository" |
Start with a task. |
talos --continue |
Continue the latest session in the current workspace. |
talos --session |
Choose a session. |
talos exec "Explain this repository" |
Run a task without the interactive interface. |
talos acp |
Connect an Agent Client Protocol client. |
talos studio |
Studio JSON-RPC server for Desktop (stdio). |
talos --help |
View command-line options. |
Inside Talos, use /provider for model connections, /settings (also /options) for the LLM judge and Classic/Collapsal interface, /sessions for history, and /help for commands and shortcuts.
Configuration and sessions are stored in ~/.talos by default (%USERPROFILE%\.talos on Windows). Uninstalling the npm package leaves this directory intact.
Run talos update or enter /update to check for a new version. Talos shows the upgrade command; installation is always manual. To upgrade, run the npm install command above again.
Release notes: 1.0.1 · 1.0.0 · 0.1.14 · 0.1.13 · 0.1.12 · 0.1.11.
Talos 1.0.1 is the current CLI line (@pakiknowledge/tal0s-code). The behaviour doctrine can now be chosen before a conversation exists: /doctrine in an empty chat picks one of the two doctrines, the status line shows the choice, and the value is applied when your first message creates the Session. The doctrine is then anchored for the life of that Session, so the system prompt prefix stays stable and later configuration edits cannot change a chat in progress. Classic stays the default skin. See verification records and current status.
The desktop GUI lives in the companion repository T3rra-C0d3-Talos.
If you encounter a problem, open an issue with your OS, Node.js version, Talos version, and the error message. Remove API keys and private project content before sharing logs.
pnpm install --frozen-lockfile
pnpm build
pnpm startSee CONTRIBUTING.md for development and verification, and source synchronization for maintaining the fork.
Talos builds on open-source work from MiniMax Code, pi-mono, and other contributors. Copyright and license notices are retained in LICENSE, NOTICE, THIRD_PARTY_NOTICES.md, and LEGAL.md.

