https://github.com/tilework-tech/nori-cli
A simple CLI for working with any agent
https://github.com/tilework-tech/nori-cli
Last synced: 14 days ago
JSON representation
A simple CLI for working with any agent
- Host: GitHub
- URL: https://github.com/tilework-tech/nori-cli
- Owner: tilework-tech
- License: apache-2.0
- Created: 2025-10-31T16:52:34.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-06-05T21:00:40.000Z (16 days ago)
- Last Synced: 2026-06-05T21:10:07.255Z (16 days ago)
- Language: Rust
- Homepage:
- Size: 49.7 MB
- Stars: 131
- Watchers: 4
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Roadmap: ROADMAP.md
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-cli-coding-agents - nori-cli - provider CLI built on Codex CLI; switch between Claude, Gemini, and Codex from the same native terminal. (Terminal-native coding agents / Open Source)
README
# Nori CLI
[](https://github.com/tilework-tech/nori-cli/actions/workflows/rust-ci.yml)
[](https://www.npmjs.com/package/nori-ai-cli)
[](https://github.com/tilework-tech/nori-cli/blob/main/LICENSE)
[](https://www.npmjs.com/package/nori-ai-cli)
**One CLI, multiple AI providers.** Nori is a local AI coding agent that lets you switch between Claude, Codex, Gemini, or any ACP compatible agent. All from the same native CLI.
## Install
```bash
npm install -g nori-ai-cli
```
Or download binaries from [GitHub Releases](https://github.com/tilework-tech/nori-cli/releases/latest).
## Quick Start
```bash
nori
```
That's it. The agent you choose will rely on existing auth if you have previously been using Claude Code, Codex, or Gemini on this system (and if not, login instructions are below). Nori launches an interactive TUI where you can chat, run commands, and let the AI assist with your codebase.
## Providers
Each provider you plan to use needs to be authenticated separately before use. Then switch between AI providers with the `/agent` command.
Currently each agent relies on an existing authenticated session on your system. If you're coming in from another CLI tool, great!
You should be good to go. If not, first follow the authentication for your desired provider:
| Provider | Authentication |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Claude | Run `npx @anthropic-ai/claude-code` in your terminal, then when the Claude CLI opens, type `/login` there. |
| Gemini | Run `npx @google/gemini-cli` in your terminal, then when the Gemini CLI opens, type `/auth` there. |
| OpenAI | In Nori, use `/agent` to switch to Codex, then run `/login` inside the Nori interface. Nori will prompt you to install OpenAI via npm if needed. |
## Bring Your Own Agent
Have your own ACP agent? Add it to Nori CLI! Any agent that speaks [Agent Client Protocol](https://github.com/agentclientprotocol/agent-client-protocol) over stdin/stdout can be registered in `~/.nori/cli/config.toml` and used alongside the built-in providers.
Add one or more `[[agents]]` entries to your config:
```toml
[[agents]]
name = "Mistral Vibe"
slug = "vibe-acp"
[agents.distribution.local]
command = "vibe-acp"
[[agents]]
name = "ElizACP"
slug = "elizacp"
[agents.distribution.local]
command = "elizacp"
args = ["acp"]
```
Then switch to your agent with `/agent` inside Nori.
**Example agents to try:**
| Agent | Install | Notes |
| ------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Mistral Vibe](https://docs.mistral.ai/mistral-vibe/introduction/install) | `curl -LsSf https://mistral.ai/vibe/install.sh \| bash` | Installs both `vibe` and `vibe-acp`. Run `vibe --setup` to configure your API key. |
| [ElizACP](https://github.com/agentclientprotocol/symposium-acp) | `cargo install --locked elizacp` | Minimal Eliza chatbot, useful for testing. |
| [Kimi](https://github.com/nicepkg/kimi-cli) | No install needed — uses `uvx` | First-time auth: run `uvx --python 3.13 kimi-cli`, then `/login`. |
Want your AI agent to configure this automatically? Point it at the raw skill file: https://github.com/tilework-tech/nori-cli/blob/main/.claude/skills/registering-custom-acp-agent/SKILL.md
## Features
- **Multi-provider**: Use Claude Code, Codex, Gemini, or your own ACP-compatible agent from the same CLI.
- **Fast native interface**: Incremental Ratatui rendering, double-buffered scrollback history, and a Rust core keep long sessions responsive.
- **Solid ACP client support**: Nori supports ACP session listing, loading, resume, context and usage metadata.
- **Agent Integrations**: Your agents keep their configurations, whether that's slash commands, skills, and MCP server forwarding.
- **Session continuity**: Pick up prior work with resume, and rewind agent changes with escape-to-undo.
- **Project context**: Reference files with `@`, flip between an editor or a file picker, and keep useful context visible without leaving the terminal.
See the [ACP roadmap](ROADMAP.md) for what is done, what is in progress, and what is planned next.
## Attribution
Nori CLI is built on the great work within [OpenAI Codex CLI](https://github.com/openai/codex).
Nori CLI relies on the great contributions within the [ACP project](https://github.com/agentclientprotocol/agent-client-protocol), from Zed Editor, JetBrains, and others.
## License
[Apache-2.0](LICENSE)