LIUTod/scream-code - AI 开源项目

A local agent with zero remote data behavior — write code, run tasks, research, code or work as you please.

Scream Code

Installation

npm install -g scream-code

[!NOTE] Requires Node.js >= 22. Git recommended. Same command installs and updates.

Quick Start

scream            # terminal UI
scream web        # browser UI (http://localhost:3210)
scream --auto     # auto permission mode
scream -y         # auto-approve mode

On first launch Scream walks you through model setup (/config). 130+ providers built in — or point it at any OpenAI-compatible endpoint with /config diy. Switch models anytime with /model, no restart needed — or use /model diy to give each sub-agent its own model, letting every model do what it does best.

When Scream wants to modify files or run commands, an approval panel pops up — pick a number, press Enter.

Features

Goal Loop — autonomous, goal-driven execution with an independent judge agent and token/time budget control.
Wolfpack — unlimited parallel sub-agents (coder / explore / plan / verify / reviewer / oracle / writer / worker).
Persistent Memory — structured pain-point memory with FTS5 full-text + tag + vector retrieval, shared across sessions.
Local Knowledge Graph — SAG-based visual knowledge base for multi-hop reasoning; import your own docs anytime.
RLM Mode — persistent Python workspace for long-running tasks, with unlimited recursive sub-agents.
Session Trace — /trace exports any session as a self-contained, offline interactive HTML timeline.
Context Search — /search (Ctrl+Shift+F) full-screen keyword search over the conversation.
High Cache Hit Rate — per-session HitR in the status bar, tuned across compatible protocols to maximize cache hits without compromising quality.
MCP / Skills / 130+ providers — all DIY-configurable; ships with browser (46 tools) and macOS desktop automation.
Remote Control — drive Scream from WeChat, Feishu, Slack, DingTalk, QQ, Telegram, Discord via cc-connect.

Slash Commands

Type / in the input to browse. All 47 commands:

Full command reference (click to expand) | Command | Description | |---------|-------------| | **Modes & execution** | | | `/auto` | Toggle auto permission mode | | `/yes` (`/yolo`) | Toggle auto-approve mode | | `/ask` | Toggle read-only Q&A mode | | `/goal [objective]` | View/manage auto goals | | `/wolfpack` (`/wp`) | Toggle wolfpack mode — auto-approve + batch concurrency | | `/rlm` | RLM mode: persistent Python workspace, unlimited recursive subagents | | `/rlm-max-depth [N]` | Set RLM recursion depth limit | | `/plan` | Toggle plan mode | | `/fusionplan` (`/fp`) | Fusion plan mode (multi-agent parallel planning) | | `/btw` | Quick question without interrupting the conversation | | `/eval` | Run end-to-end tests (agent health check) | | **Session** | | | `/new` (`/clear`) | Start a new session | | `/sessions` (`/resume`) | Browse and restore sessions | | `/compact` | Compact conversation context | | `/fork` | Copy session into a new branch | | `/title` (`/rename`) | Set or show session title | | `/revoke [N]` | Undo the last N conversation rounds | | `/export-md` (`/export`) | Export session as Markdown | | `/export-debug-zip` | Export session as debug ZIP | | `/status` | Show session and runtime status | | `/usage` | Show token usage and context window | | **Memory & knowledge** | | | `/memory` (`/memo`, `/mem`) `[query]` | Browse, search, inject memory memos | | `/knowledge` (`/know`) `[query]` | Manage local knowledge base | | **Models & configuration** | | | `/model [alias]` | Switch LLM model | | `/config` | Browse and configure models | | `/logout` (`/disconnect`) | Remove configured models | | `/language` (`/lang`) | Switch interface language | | `/theme` | Set terminal UI theme | | `/permission` | Select permission mode | | `/editor` | Set external editor | | `/settings` | Open TUI settings | | `/init` | Analyze codebase and generate AGENTS.md | | `/update` | Update Scream Code | | `/version` | Show version info | | **Extensions** | | | `/mcp` | Manage MCP servers | | `/skill` (`/skills`, `/plugin`) | Skill center | | `/make-skill` | Distill the session into a Skill | | `/cc` | Control your cc daemon | | `/cc-connect` | cc-connect quick channel setup | | **Tools** | | | `/search` | Search the conversation (Esc to close) | | `/trace` | View the session working trajectory | | `/hl` (`/highlight`) | Toggle user-message highlight block | | `/snaptimer` (`/timer`) | Toggle per-turn elapsed timer | | `/tasks` (`/task`) | Browse background tasks | | `/like` | Set your preferences | | `/help` (`/h`) | Show commands and shortcuts | | `/exit` (`/quit`, `/q`) | Exit application |

Shortcuts: Ctrl+S interrupt · Ctrl+C cancel · Ctrl+O expand tool output · Ctrl+Shift+F search · Shift+Tab plan mode · Shift+Enter new line · Tab (empty) cycle thinking effort · @ mention a file

Web UI

The browser UI shares the same agent-core as the TUI — zero feature loss. Multi-session sidebar, model & thinking-effort switching, light/dark/system themes, mobile-friendly. Binds 127.0.0.1 only — no external access.

Documentation

Website: scream.chat

Contributing

Free and open — forks, feedback and pull requests are welcome. Scream is a lightweight agent foundation: maximize the model's own capability, don't over-constrain it with framework. Inspired by pi, pi-tui, gork, kimicli, Gemini, ohmypi, zero and others.

GitHub · scream.chat · MIT License · Made with ❤️ by LIUTod