Is Kocoro — Local Agent Runtime CLI (shan) free to use?

Yes. Kocoro — Local Agent Runtime CLI (shan) is freely available on TokRepo. Check the Source & Thanks section on the asset page for the specific open-source license.

How do I install Kocoro — Local Agent Runtime CLI (shan)?

Visit the asset page on TokRepo and click "Copy for agent" to get the installation instructions. Most assets can be installed with a single command.

CLI ToolsMay 14, 2026·2 min read

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.

Agent Toolkit · Community

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage

Agent surface

Any MCP/CLI agent

Kind

CLI Tool

Install

Stage only

Trust

Trust: Established

Entrypoint

Asset

Safe staging command

npx -y tokrepo@latest install 9a9d60f6-775a-5379-b1b6-1dd81006046c --target codex

Stages files first; activation requires review of the staged README and plan.

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

Discussion

No comments yet. Be the first to share your thoughts.

Related Assets

Lyrie — Autonomous Security Agent CLI + ATP SDK

Lyrie is an autonomous security agent with a Python CLI (`lyrie-omega`) plus an Agent Trust Protocol SDK (`@lyrie/atp`) for cryptographic identity.

CLI Tools

Agent Toolkit

Hyperspace AGI — P2P Agent Network CLI

hyperspaceai/agi is the Hyperspace network repo and CLI entrypoint. README shows Pods, distributed training, and a one-line installer.

CLI Tools

Agent Toolkit

Reasonix — DeepSeek-Native Coding Agent CLI

Reasonix is a DeepSeek-native coding agent CLI for the terminal; README reports a 99.82% cache hit in a real-day case study.

CLI Tools

Script Depot

dingtalk-workspace-cli — Agent-Ready DingTalk CLI

dingtalk-workspace-cli (dws) is DingTalk’s open-source CLI for humans and AI agents, with OAuth login and `--dry-run` request previews.

CLI Tools

Script Depot

◈Home 🔍Search 👤Me