Runai

English | 中文

A terminal-based resource manager for AI CLI skills, MCP servers, and groups. Works across Claude Code, Codex, Gemini CLI, and OpenCode.

Features

• TUI Interface — Browse, enable/disable, search skills and MCPs with a terminal UI
• Multi-CLI Support — Manage resources across 4 AI CLIs, switch targets with 1234
• Groups — Organize skills/MCPs into groups, batch enable/disable, rename
• One-Step Install — runai install owner/repo downloads, registers, groups, and enables
• Market Install — Browse 2000+ skills, Enter to install directly from TUI Market tab
• Skill Discovery — Built-in recursive scanner finds all SKILL.md on disk in seconds
• Unified Search — sm_search searches installed resources and market at once
• Usage Tracking — Track skill usage count and last-used time, identify unused skills
• MCP Server — 30 tools exposed via MCP protocol, auto-registered to all CLIs on first launch
• Batch Operations — Batch enable/disable/delete/install multiple resources in one call
• Multi-CLI Config — Native format support: Claude JSON, Codex TOML, OpenCode custom JSON, Gemini JSON
• Dark/Light Theme — Press t to toggle, optimized for both terminal backgrounds
• Filesystem as Source of Truth — Skill enabled = symlink exists; MCP enabled = config entry exists
• Backup & Restore — Timestamped full backups of skill directories, MCP configs, and CLI configs
• Auto Migration — Seamless upgrade from skill-manager to runai (data dir, DB, symlinks, MCP entries)
• CLI — Subcommands for scripting and automation

Install

git clone https://github.com/Crosery/runai.git
cd runai
cargo install --path .

Quick Start

# Launch TUI (first run will scan, register MCP, and migrate from skill-manager if needed)
runai

# Install skills from GitHub (auto-download, register, group, enable)
runai install pbakaus/impeccable
runai install MiniMax-AI/skills

# Install from market
runai market-install github

# Show usage statistics
runai usage --top 10

# Discover all skills on disk
runai discover

# CLI management
runai list                    # List all skills and MCPs
runai status                  # Show enabled counts
runai enable brainstorming    # Enable a skill
runai scan                    # Scan known directories
runai backup                  # Create a backup

TUI Keybindings

Footer shows essential keys. Press ? for full help panel.

Key	Action
j/k	Navigate up/down
H/L or Tab	Switch tabs (Skills / MCPs / Groups / Market)
Space	Toggle enable/disable
Enter	Open group detail / Install from market
/	Search filter
1234	Switch CLI target (Claude/Codex/Gemini/OpenCode)
i	Install from GitHub
t	Toggle dark/light theme
?	Help panel (all keybindings)
q	Quit

MCP Tools (30)

When running as MCP server (runai mcp-serve), 30 tools are available:

Skills & MCPs

Tool	Description
sm_list	List skills/MCPs with usage count (supports kind/group/target filters)
sm_status	Enabled/total counts per CLI target
sm_enable / sm_disable	Toggle skill/MCP for a CLI (supports fuzzy group name)
sm_delete	Remove a skill/MCP (files + symlinks + DB)
sm_scan	Scan known directories for new skills
sm_discover	Find all SKILL.md on disk, returns unmanaged skills
sm_search	Unified search across installed resources + market
sm_batch_enable / sm_batch_disable	Batch toggle multiple by name list

Install

Tool	Description
sm_install	Returns CLI command for fast GitHub install (agent runs via Bash)
sm_market	Browse cached market skills (filter by source/search/repo path)
sm_market_install	Returns CLI command for market install
sm_batch_install	Returns CLI commands for installing multiple skills at once
sm_sources	List/add/remove/enable/disable market sources

Groups

Tool	Description
sm_groups	List all groups with member counts
sm_create_group / sm_delete_group	Create or delete a group
sm_group_add / sm_group_remove	Add/remove members (single name or batch names)
sm_update_group	Update group name and/or description
sm_group_enable / sm_group_disable	Batch toggle all members (fuzzy group match)

Usage Tracking

Tool	Description
sm_record_usage	Record a usage event for a skill or MCP
sm_usage_stats	Show usage statistics sorted by most used

Backup & Utility

Tool	Description
sm_backup	Create timestamped backup
sm_restore	Restore from backup (latest or by timestamp)
sm_backups	List all available backups
sm_register	Register MCP to all CLI configs
sm_batch_delete	Delete multiple resources at once

Multi-CLI Config Formats

CLI	Config File	Format
Claude	~/.claude.json	JSON (mcpServers)
Codex	~/.codex/config.toml	TOML ([mcp_servers.*])
Gemini	~/.gemini/settings.json	JSON (mcpServers)
OpenCode	~/.config/opencode/opencode.json	JSON (mcp, command=array)

Data

All data stored in ~/.runai/:

• skills/ — Managed skill directories (each with SKILL.md)
• mcps/ — Disabled MCP config backups (JSON)
• groups/ — Group definitions (TOML files)
• backups/ — Timestamped full backups
• market-cache/ — Cached market skill lists (JSON, 1hr TTL)
• market-sources.json — Custom market sources
• runai.db — SQLite database (skill metadata, usage stats, group members)

Migration from skill-manager

Runai v0.5.0 auto-migrates on first launch:

1. Data directory: ~/.skill-manager/ → ~/.runai/
2. Database: skill-manager.db → runai.db
3. Symlinks: all CLI skill symlinks repointed automatically
4. MCP entries: skill-manager → runai in all CLI configs
5. Environment variables: both RUNE_DATA_DIR and SKILL_MANAGER_DATA_DIR accepted

No manual steps needed. All data is preserved.

License

MIT