# Kocoro — Local Agent Runtime CLI (shan)

> Run agents locally via the `shan` CLI with interactive TUI, daemon mode, tools, and MCP integrations; verified 263★ and installs via npm or script.

## Install

Copy the content below into your project:

## Quick Use

```bash
npm install -g @kocoro/kocoro
shan --help
shan --setup
shan "what happened in the news today"
```

## Intro

Run agents locally via the `shan` CLI with interactive TUI, daemon mode, tools, and MCP integrations; verified 263★ and installs via npm or script.

**Best for:** Developers who want a local agent runtime with tools and integrations

**Works with:** macOS/Linux terminals · npm or Go build · optional Ollama or cloud gateway

**Setup time:** 8–20 minutes

### Key facts (verified)

- GitHub: 263 stars · 111 forks · pushed 2026-05-14.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `npm install -g @kocoro/kocoro`.

## Main

- Use `shan` in interactive mode for terminal chat, and one-shot mode for scripted Q&A and quick tasks.

- Set up your provider with `shan --setup` (cloud gateway, self-hosted gateway, or local Ollama per README).

- Treat tools as first-class: file ops, archives, process management, and optional MCP integrations via config.

- Use named agents (`--agent`) to isolate instructions/memory for separate roles (ops-bot, writer, etc.).

### Source-backed notes

- README lists install options (npm, install script, Go build) and verifies with `shan --help`.
- README includes a quick start with interactive mode, one-shot mode, named agents, and setup command.

### FAQ

- **Do I need Shannon Cloud?**: No — README describes self-hosted gateway and local Ollama options as alternatives.
- **How do I keep runs reproducible?**: Use named agents and explicit commands; keep provider settings stable.
- **Is there an MCP angle?**: README mentions MCP client integrations via configuration for third-party tools.

## Source & Thanks

> Source: https://github.com/Kocoro-lab/Kocoro
> License: MIT
> GitHub stars: 263 · forks: 111

---

<!-- ZH -->

## Quick Use

```bash
npm install -g @kocoro/kocoro
shan --help
shan --setup
shan "what happened in the news today"
```

## Intro

用 `shan` CLI 本地运行 agent：交互式 TUI、daemon、工具集与 MCP 集成；已验证 263★，支持 npm/脚本安装，并提供 `--setup` 配置流程与命名 agent 用法。

**Best for:** 需要本地 agent 运行时、并希望具备工具与集成能力的开发者

**Works with:** macOS/Linux 终端 · npm 或 Go 构建 · 可选 Ollama 或云端网关

**Setup time:** 8–20 minutes

### Key facts (verified)

- GitHub：263 stars · 111 forks；最近更新 2026-05-14。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`npm install -g @kocoro/kocoro`。

## Main

- 交互模式直接运行 `shan`，一次性任务用 `shan "..."`，便于脚本化与快速问答。

- 按 README 用 `shan --setup` 配置 provider（云端网关/自建网关/本地 Ollama）。

- 把工具当原语：文件/归档/进程等本地工具 + 可选 MCP 集成，形成可复用的执行面。

- 用 `--agent` 创建命名 agent，隔离指令与记忆（如 ops-bot、writer），适合多角色协作。

### Source-backed notes

- README 给出 npm/安装脚本/Go 构建三种安装方式，并以 `shan --help` 验证安装。
- README 的 Quick Start 包含交互/一次性/命名 agent/`--setup` 等关键入口命令。

### FAQ

- **必须用 Shannon Cloud 吗？**：不必：README 提到可自建网关或用本地 Ollama 作为替代方案。
- **如何更可复现？**：使用命名 agent + 显式命令，并固定 provider/配置以减少漂移。
- **和 MCP 有关系吗？**：README 提到可通过配置接入第三方 MCP 集成，扩展工具能力。

## Source & Thanks

> Source: https://github.com/Kocoro-lab/Kocoro
> License: MIT
> GitHub stars: 263 · forks: 111


---
Source: https://tokrepo.com/en/workflows/kocoro-local-agent-runtime-cli-shan
Author: Agent Toolkit