AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs, papers, images, or videos into a queryable knowledge graph. App code + database schema + infrastructure in one graph.
pip install pipxLightweight, open-source AI agent for your tools, chats, and workflows.
git clone https://github.com/HKUDS/nanobot.gitSkills Catalog for Codex
Codex uses skills to help package capabilities that teams and individuals can use to complete specific tasks in a repeatable way. This repository catalogs skills for use and distribution with Codex.
Learn more:
- [Using skills in Codex](https://developers.openai.com/codex/skills)
- [Create custom skills in Codex](https://developers.openai.com/codex/skills/create-skill)
- [Agent Skills open standard](https://agentskills.io)
## Installing a skill
Skills in [Supports Claude Code, Codex, Mcp
Shows active maintenance signals
Carries strong trust indicators from repository metadata
755 GitHub stars recorded
pip install cheetahclaws
Works on Linux, macOS, WSL2, and Android (Termux) (Python 3.10+). First run guides you through provider + API-key setup; re-run anytime with cheetahclaws --setup.
Windows: native Windows is not supported — use WSL2. Android/Termux:
pkg install python git && pip install cheetahclaws.
curl -fsSL https://raw.githubusercontent.com/SafeRL-Lab/cheetahclaws/main/scripts/install.sh | bash
After installation, reload your shell so cheetahclaws is on PATH:
source ~/.zshrc # macOS
# or: source ~/.bashrc # Linux
cheetahclaws # start chatting!
pip from source codegit clone https://github.com/SafeRL-Lab/cheetahclaws.git
cd cheetahclaws
pip install . # then: cheetahclaws
git pull && pip install --force-reinstall . # to update
pip install ".[voice]" # voice input (sounddevice + faster-whisper)
pip install ".[vision]" # clipboard image capture (Pillow)
pip install ".[autosuggest]"# typing-time slash autosuggest (prompt_toolkit)
pip install ".[browser]" # headless browser (playwright); then: playwright install chromium
pip install ".[files]" # PDF + Excel reading (pymupdf, openpyxl)
pip install ".[ocr]" # image OCR (pytesseract)
pip install ".[trading]" # trading agent (yfinance, rank-bm25)
pip install ".[qq]" # QQ bot bridge (qq-botpy)
pip install ".[litellm]" # AWS Bedrock / Azure / Vertex auth via litellm
pip install ".[all]" # everything above
uvgit clone https://github.com/SafeRL-Lab/cheetahclaws.git && cd cheetahclaws
uv tool install ".[all]" # minimal: uv tool install .
uv tool install ".[all]" --reinstall # update · uv tool uninstall cheetahclaws
git clone https://github.com/SafeRL-Lab/cheetahclaws.git && cd cheetahclaws
pip install -r requirements.txt
python cheetahclaws.py # changes take effect immediately
| Feature | Details |
|---|---|
| Multi-provider | Anthropic · OpenAI · Gemini · Kimi · Qwen · Zhipu · DeepSeek · MiniMax · Ollama · LM Studio · Custom endpoint |
| Agent loop | Streaming API + automatic tool-use loop; the whole loop is in agent.py |
| 28 built-in tools | Read · Write · Edit · Bash · Glob · Grep · WebFetch · WebSearch · NotebookEdit · GetDiagnostics · Memory* · Agent/SendMessage · Skill · AskUserQuestion · Task* · SleepTimer · EnterPlanMode/ExitPlanMode · (MCP + plugin tools auto-added) |
| MCP integration | Connect any MCP server (stdio/SSE/HTTP); tools auto-registered — see extensions guide |
| Plugin system | Install/enable/update plugins from git URLs or local paths; multi-scope; recommendation engine |
| Task management | TaskCreate/Update/Get/List, sequential IDs, dependency edges, persisted to .cheetahclaws/tasks.json |
| Context compression | Four cooperating layers — dynamic max_tokens cap, per-model context-window registry, two-layer snip + AI summarize at 70%, and auto-fanout for oversized tool outputs. Details |
| Persistent memory | Dual-scope (user + project), 4 types, confidence/source metadata, conflict detection, recency-weighted search, /memory consolidate. Verification-anchored staleness — freshness tracks a last_verified date (not file mtime), so reading a memory can't fake-refresh it; only MemoryVerify resets the clock. Details |
| Multi-agent | Spawn typed sub-agents (coder/reviewer/researcher/…), git-worktree isolation, background mode |
| Permission system | auto / accept-edits / accept-all / manual / plan modes (accept-edits = auto-run edits, still ask for other Bash; hard denylist blocks host-destroying commands in every mode) |
| Checkpoints & plan mode | Auto-snapshot conversation + files each turn (/checkpoint, /rewind); /plan read-only analysis mode |
| Slash commands & themes | 50+ slash commands with Tab-complete; /theme offers 15 curated palettes |
| Brainstorm → Worker | /brainstorm runs an N-persona debate → todo_list.txt; /worker auto-implements the pending tasks |
| SSJ Developer Mode | /ssj — persistent power menu chaining Brainstorm, Worker, Review, Trading, Agent, Video/TTS, Monitor, etc. |
| Trading agent | /trading multi-agent analysis, backtesting, paper-trade calibration, MV portfolios. Guide |
| Monitor | /monitor subscribes to AI-monitored topics on a schedule (arxiv / stock / crypto / news / custom), pushes reports to bridges/console |
| Research (multi-source) | /research fans out to 20 sources with attention heat table, entity extraction, trend sparkline, comparison mode. Guide |
| Autonomous agents | /agent background loops from Markdown templates; iteration summaries pushed via bridge; stagnation-stop guard |
| Bridges + remote control | Telegram · WeChat · Slack · QQ — chat round-trip, slash passthrough, per-bridge job queue (!jobs/!retry/!cancel). Guide |
| Voice / Vision / Video / TTS | Offline Whisper /voice; /image clipboard vision (local + cloud); /video + /tts content factories. Guide |
| Web UI | --web — multi-user browser chat + PTY terminal. Guide |
| More | Tmux integration · !cmd shell escape · proactive monitoring · 3×Ctrl+C force-quit · session persistence · /cloudsave GitHub-Gist sync · cost tracking · --print non-interactive mode |
Full feature reference — every row above with complete detail (context-compression layers, auto-fanout, 15 themes, the full Trading/Research/Agents writeups, …): docs/guides/features.md.
/image now enriches the prompt with local OCR textpytesseracttesseractCHEETAHCLAWS_IMAGE_OCR=0accept-edits permission mode (auto-run file edits, still ask before non-allow-listed Bash) — the middle ground between auto and accept-all; also exposes the existing plan mode in /permissions and corrects the prompt's misleading auto description. Detailslast_verified date instead of file mtime, so reading a memory can't fake-refresh a stale one (PR #150); new MemoryVerify tool is the only thing that resets the clock, the prompt tells the agent to call it after re-checking, and the injected memory manifest ranks by verified recency. Detailsdesktop/; version-string format unified to v3.5.x. Detailscheetahclaws package (from cheetahclaws import kernel), removing sys.path name-collision crashes at startup — breaking only if you import internals directly; full suite green (2449 passed). Detailscheetahclaws on PATH, and local Ollama models that emit tool calls as text now actually execute them (two fixes from #131). Details/budget $5 / /budget daily $20 cap spend per session or day, enforced before each model call. Details/context grid and 1M context for deepseek-v4-flash. DetailsFor more news, see here.