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

English | 简体中文

---

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