35dc87ef53
- Rebrand commits already in history (gsd → forge) - Sync pre-existing doc, docker, and CI config updates - All rebrand artifacts verified in place: * Native crates: forge-engine, forge-ast, forge-grep * Log prefixes: [forge] across 22+ files * Binary: ~/bin/sf-run * Workspace scopes: @sf-run/*, @singularity-forge/* * Nix flake: Rust toolchain ready System ready for: nix develop && bun run build:native Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# CLI Flags
|
|
|
|
## Starting SF
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `gsd` | Start a new interactive session |
|
|
| `gsd --continue` (`-c`) | Resume the most recent session |
|
|
| `gsd --model <id>` | Override the default model for this session |
|
|
| `gsd --web [path]` | Start browser-based web interface |
|
|
| `gsd --worktree` (`-w`) [name] | Start in a git worktree |
|
|
| `gsd --no-session` | Disable session persistence |
|
|
| `gsd --extension <path>` | Load an additional extension (repeatable) |
|
|
| `gsd --append-system-prompt <text>` | Append text to the system prompt |
|
|
| `gsd --tools <list>` | Comma-separated tools to enable |
|
|
| `gsd --version` (`-v`) | Print version and exit |
|
|
| `gsd --help` (`-h`) | Print help and exit |
|
|
| `gsd --debug` | Enable diagnostic logging |
|
|
|
|
## Non-Interactive Modes
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `gsd --print "msg"` (`-p`) | Single-shot prompt mode (no TUI) |
|
|
| `gsd --mode <text\|json\|rpc\|mcp>` | Output mode for non-interactive use |
|
|
|
|
## Session Management
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `gsd sessions` | Interactive session picker — list and resume saved sessions |
|
|
| `gsd --list-models [search]` | List available models and exit |
|
|
|
|
## Configuration
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `gsd config` | Set up global API keys |
|
|
| `gsd update` | Update to the latest version |
|
|
|
|
## Headless Mode
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `gsd headless` | Run without TUI |
|
|
| `gsd headless --timeout N` | Timeout in ms (default: 300000) |
|
|
| `gsd headless --max-restarts N` | Auto-restart on crash (default: 3) |
|
|
| `gsd headless --json` | Stream events as JSONL |
|
|
| `gsd headless --model ID` | Override model |
|
|
| `gsd headless --context <file>` | Context file for `new-milestone` |
|
|
| `gsd headless --context-text <text>` | Inline context for `new-milestone` |
|
|
| `gsd headless --auto` | Chain into auto mode after milestone creation |
|
|
| `gsd headless query` | Instant JSON state snapshot (~50ms) |
|
|
|
|
## Web Interface
|
|
|
|
| Flag | Default | Description |
|
|
|------|---------|-------------|
|
|
| `--host` | `localhost` | Bind address |
|
|
| `--port` | `3000` | Port |
|
|
| `--allowed-origins` | (none) | CORS origins |
|