Schway

A lean, fast coding agent for your terminal.

Quick start

1. npm install -g schway requires Bun 1.2+ on PATH.
2. Run schway, press Alt+L, and pick a sign-in method.
3. Type a task in the editor and press Enter.

Use --approval <auto|ask|read-only> or approval.mode to choose the starting tool approval mode. In the TUI, Shift+Tab cycles modes; ask previews tools that can change state before you approve them, and read-only refuses them. Headless ask denies mutations without waiting for input.

Run a headless task

Choose the auth route and model explicitly; interactive sign-in does not save a headless model choice. This POSIX shell example assumes you saved an OpenAI API key using interactive /login openai. It selects API-key billing even if a ChatGPT login also exists. For ChatGPT/Codex, xAI, Grok or a compatible endpoint, use the complete route guides.

schway models list --provider openai --openai-auth api-key
# Paste one exact model ID returned above, then press Enter.
IFS= read -r MODEL_ID
schway -p "Explain this project" --provider openai --openai-auth api-key --model "$MODEL_ID" --approval read-only --show-session
schway sessions list
# Paste the exact Session hint ID or its matching saved-work row.
IFS= read -r SESSION_ID
schway -p "Continue this explanation" --provider openai --openai-auth api-key --model "$MODEL_ID" --resume "$SESSION_ID" --approval read-only --show-session

The hint goes to stderr; model text stays on stdout. Task --json already emits session.ready as JSONL and cannot be combined with --show-session. Resume restores saved work, while current flags/config still choose credentials and billing. See headless output and recovery, credentials, configuration, doctor and sessions.

Learn more

• Use the terminal interface
• Configure models and preferences
• Manage credentials
• Save, branch, and resume sessions
• Attach workspaces
• Use Agent Skills
• Add skills and extensions · Public extension API
• Diagnose local readiness
• Run headless tasks
• Embed a native scripted turn · Public host API
• Read tool output

Development

bun install
bun test
bun run typecheck
bun run dev

Run coding evals

See the stability policy for compatibility promises.