s-app-scoder-agent 0.8.20 → 0.9.2

package/README.md

@@ -1,4 +1,6 @@
-# scoder — Autonomous Coding Agent CLI
+# scoder — Autonomous Coding Agent CLI
+
+**Current version: 0.9.2**
 
 [![CI](https://github.com/nbhson/app-scoder-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/nbhson/app-scoder-agent/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
@@ -50,8 +52,11 @@ export OPENAI_BASE_URL=https://api.openai.com/v1  # optional, for custom endpoin
 # Run a task
 scoder "add a ping function to src/network.ts"
 
-# Interactive REPL (supports /help, /clear, /cost, /model, /skills, /skill, /mcp, /review, /permission)
-scoder
+# Interactive REPL (supports /help, /clear, /compact, /cost, /model, /skills, /skill, /mcp, /review, /permission)
+scoder
+
+# Full-screen TUI with rich agent display
+scoder tui
 ```
 
 ## How It Works
@@ -105,7 +110,6 @@ Safety defaults:
 | `SCODER_MAX_STEPS` | `40` | Max loop iterations before giving up |
 | `SCODER_PERMISSION` | `auto` | Permission mode: `auto` \| `ask` \| `readonly` |
 | `SCODER_STREAM` | `1` | `0` to disable streaming LLM output |
-| `SCODER_STREAM` | `1` | `0` to disable streaming LLM output |
 | `SCODER_SERVER_TOKEN` | — | `scoder serve` only: require `Authorization: Bearer <token>` |
 | `SCODER_WEB_ALLOW_PRIVATE` | — | Set to `1` to let `web_fetch` reach localhost/private addresses (local dev) |
 | `SCODER_NO_APIKEY_WARNING` | — | Set to `1` to suppress the apiKey-in-rc warning |
@@ -233,18 +237,46 @@ Read the current diff. Check for: null derefs, injection risks, ...
 | Command | Description |
 |---|---|
 | `/help` | command list |
+| `/plan` | show the current plan; `/plan done\|start <id\|n>` to mark steps |
+| `/agent` | list/select primary agents (build/plan/review/custom) |
+| `/init` | create an AGENTS.md template in this project |
+| `/sessions` | list saved sessions; `/sessions resume <id\|last>` |
+| `/diff` | show diffs: `/diff turn\|session\|branch` (TUI) |
+| `/theme` | switch palette (TUI) |
 | `/clear` | reset conversation + agent context |
+| `/compact` | summarize older history now (manual compaction) |
 | `/cost` | session token usage |
 | `/model` | active model/provider/build |
 | `/skills` | list discovered skills |
 | `/skill <name>` | stage a skill for the next task |
 | `/mcp` | MCP servers + tools; exec one directly: `/mcp <server> <tool> [json\|text]` or `/mcp mcp__server__tool [json\|text]` — non-JSON text binds to the tool's first string parameter |
 | `/review <prompt>` | Prompt gate (prompt-gate MCP): LLM rewrites your prompt, you pick original/rewritten/update/cancel — only the approved prompt is used |
-| `/permission <auto\|readonly>` | switch permission mode at runtime |
+| `/permission <auto\|ask\|readonly>` | switch permission mode at runtime |
+| `/undo` | revert files (and optionally trim the turn) (TUI) |
+| `/commands` | list all commands (builtin + custom) |
+| `/export [md\|json]` | export session transcript |
+| `/search <query>` | search the transcript |
 | `/exit` | quit |
 
 In the TUI, **Tab** completes commands (and `/skill` names, `/mcp <server> <tool>` arguments), **↑/↓** recall sent-message history.
 
+### Context compaction
+
+Long runs are summarized automatically when history reaches `contextWindow × trigger` (default **80%**). Mechanical trimming only starts later, at **95%** of the window, so compaction gets the first chance to preserve task state. `/compact` runs the same summarization immediately (useful mid-session or when auto-compaction is disabled).
+
+```jsonc
+// .scoderrc.json — all fields optional
+"compaction": {
+  "trigger": 0.8,      // fraction of the model window that triggers compaction
+  "keep": 0.15,        // recent-history fraction kept verbatim
+  "buffer": 0.15,      // extra recent-history fraction never summarized
+  "contextWindow": 128000 // override the model-catalog window
+}
+// "compaction": false disables automatic compaction (mechanical trim only)
+```
+
+`/compact` remains available even when automatic compaction is disabled.
+
 ### @file mentions
 
 Prefix any path with `@` in your task to inline its content into the agent's context:
@@ -322,6 +354,13 @@ scoder can use tools from [MCP](https://modelcontextprotocol.io) servers configu
 - Built-in tools always take priority over MCP tools with colliding names
 - ⚠️ **MCP tools bypass the built-in permission system** (no command classification, no diff preview). In `readonly` mode they are therefore disabled entirely; in `auto`/`ask` mode they run unsandboxed — only add MCP servers you trust.
 
+### MCP governance
+
+Each server supports `enabled`, `trust` (`auto`/`ask`/`readonly`/`deny`), `tools.include`/`exclude`
+(globs), and `timeoutMs`. `readonly` servers are never spawned. Import existing configs with
+`scoder mcp import`. MCP tool output is flagged `untrusted` and wrapped with an `[UNTRUSTED]`
+marker; audit entries are written to the JSONL log.
+
 ### Prompt gate (`/review`)
 
 If the [`prompt-gate`](https://github.com/nbhson/s-universal-prompt-gate-mcp) MCP server is configured (`~/.scoder/config.json`), `/review <prompt>` runs the gated rewrite flow — like OpenCode's `review-and-select-prompt`:
@@ -377,7 +416,7 @@ Features:
 - **Header row 2** — (no longer present; phase breadcrumb + metrics moved into the sidebar / status bar to avoid duplication)
 - **Diff cards** (`✎`) — every file write/edit renders as a unified diff (`+` green / `-` red / `@@` cyan hunk headers); the same diff also flows out of the HTTP SSE stream
 - **Status bar** — model, token usage (input/output/cached), scroll position, keybind hints
-- **Slash commands** — `/help`, `/clear`, `/cost`, `/model`, `/skills`, `/skill`, `/mcp`, `/review`, `/permission`, `/exit` (identical to the REPL)
+- **Slash commands** — `/help`, `/clear`, `/compact`, `/cost`, `/model`, `/skills`, `/skill`, `/mcp`, `/review`, `/permission`, `/exit` (identical to the REPL)
 - **Multi-turn** — keep typing follow-ups after a task finishes; the conversation context carries over (same as the REPL)
 - **Scrollback** — `PgUp`/`PgDn` page in 0.8-viewport steps, `Home`/`End` jump to top/bottom, `Esc` returns to the live tail (press again to abort); rendering is capped at the last 200 items for smooth scrolling on long runs
 - **Keybinds** — `Enter` send · `PgUp`/`PgDn` scroll · `Esc` reset scroll / abort · `Ctrl+C` quit
@@ -469,7 +508,12 @@ scoder --help | --version     Help and version
 | `--permission <mode>` | `auto` \| `ask` \| `readonly` shell-command policy (default `auto`) |
 | `-y` | Non-interactive mode (denies commands needing confirmation) |
 | `--provider <name>` | `openai` \| `anthropic` (env SCODER_PROVIDER; auto-detected) |
+| `--agent <name>` | Primary agent to run (build/plan/review/custom) |
 | `--no-save` | Disable session auto-save to `.scoder/sessions/` |
+| `--no-color` | Disable colored output |
+| `--no-motion` | Disable animations |
+| `--plain` | Plain (monochrome) output |
+| `--high-contrast` | High-contrast theme |
 | `--log-file` | Write a structured JSONL event log to `.scoder/logs/` |
 | `--port <n>` | (`serve`) TCP port, `0` = random free port |
 | `--host <addr>` | (`serve`) Bind address (default `127.0.0.1`) |