Skip to content

About

Talos: a provider-neutral coding agent with an interface design reminiscent of the industrialized cluster management systems on Talos-II (I'm just making that up).

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

247 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Talos

A coding agent for your terminal. Bring your model, work in your project, and follow every step.

简体中文 · Install · Quick start · npm

Talos welcome screen

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.

Install

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=optional

Install scripts are needed for native dependencies. Keep optional dependencies enabled.

Quick start

Open a terminal in the project you want to work on:

cd /path/to/your/project
talos
  1. Enter /provider to configure a model connection. Select a preset or supply your endpoint, model name, and API key.
  2. Describe your task and the result you want. For example: “Explain how this project starts, then identify the files involved.”
  3. Follow the replies and tool activity. Review permission requests when prompted. In Auto, /settings can point those asks at your own LLM judge.

Model usage is billed by your chosen provider.

A conversation in Talos

Collapsal welcome (Classic remains the default). The wallpaper and transparency are terminal settings.

Keep working

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.

Your data

Configuration and sessions are stored in ~/.talos by default (%USERPROFILE%\.talos on Windows). Uninstalling the npm package leaves this directory intact.

Updates

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.

Release status

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.

Build from source

pnpm install --frozen-lockfile
pnpm build
pnpm start

See CONTRIBUTING.md for development and verification, and source synchronization for maintaining the fork.

License and acknowledgements

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.

About

Talos: a provider-neutral coding agent with an interface design reminiscent of the industrialized cluster management systems on Talos-II (I'm just making that up).

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages