Claudin

One coding agent CLI. Any LLM.

Claudin brings a terminal-first agentic workflow — bash, file tools, grep, glob, agents, MCP, slash commands, streaming — to any model provider. Switch between OpenAI, Gemini, DeepSeek, Ollama, Mistral, GitHub Copilot, Bedrock, Vertex, and 200+ OpenAI-compatible endpoints without changing your workflow.

Install

Install the native binary for your platform:

curl -fsSL https://claudiolabs.ai/install.sh | sh

Or install through npm (needs Node.js 22.19+):

npm install -g @claudiolabs/claudin@latest

On Arch Linux (and Omarchy), there is a pacman package. It installs the same release binary — nothing is compiled from source:

git clone https://github.com/claudio-labs/claudin
cd claudin/packaging/aur/claudin-bin && makepkg -si

It is not on the AUR yet — new AUR account registration has been closed since June 2026 — so pacman -Syu will not update it. Re-run makepkg -si after a release, or stay on npm until claudin-bin is published.

If you already have Claudin from npm or Bun, remove it first so the two do not fight over $PATH: npm rm -g @claudiolabs/claudin.

Documentation

Full documentation lives at claudiolabs.ai/docs.

• Install — platform binaries, the Node fallback, and first run.
• Providers — every preset, OAuth vs. API key, local endpoints.
• Migrating from Claude Code — what carries over and what changes.
• Configuration — settings, permissions, and interface options.
• Agents and workflows — sub-agents, isolated worktrees, and the self-hosted background agent.
• Skills, plugins, MCP, and hooks — extend the agent.
• Automation — headless claudin -p for pipes and CI.
• Cache policy and the bash output filter — the token and cost behavior that ships on by default.

In this repository: docs/playbook.md — a day-to-day guide to running Claudin against a local model with Ollama.

Run /help inside the app for the full command list.

Build from Source

bun install && bun run build && node dist/cli.mjs

Dev binary (claudindev)

Local checkouts only produce a dev binary — the stable release is never built locally, it comes from npm. To work with both:

npm install -g @claudiolabs/claudin@latest   # stable release → `claudin`
bun run link:dev                              # local build    → `claudindev`

link:dev symlinks <repo>/bin/claudin as claudindev in ~/.bun/bin or ~/.local/bin, so claudin stays pinned to the published release while claudindev picks up every bun run build from your checkout.

See CONTRIBUTING.md for the build system, feature flags, and pre-PR checks.

Screenshot

Launching Claudin shows the active provider, model, and effort in the banner and in the footer, so you can tell at a glance which build and profile you are on:

Sponsor

Claudin is independent and free, and stays that way. If it saves you time, you can tip the project over Lightning at claudiolabs.ai/sponsor — entirely optional, and it unlocks nothing.

License

Released under the MIT License. Claudin is an independent project and is not affiliated with or endorsed by any model provider.