[ SIMPLY DEVLY ] F1=Help

[ Usage Guide ]

Using siply

siply is a terminal-native AI coding tool. It shows you everything it does. No black boxes. No surprises.

How it works

siply runs an AI agent loop in your terminal. You give it a task. It plans, uses tools (file reads, edits, shell commands), and shows you every action before it executes.

The siply difference

Every AI coding tool hides what it does. siply shows everything. You see the tool call, the file path, the proposed edit — and approve or skip it.

Interactive Mode

Start the TUI and chat with the agent:

$ siply
┌─ siply v0.1.0-alpha ──────────────────────────┐
│ Provider: Anthropic · Model: claude-sonnet │
│ Workspace: /your/project │
└───────────────────────────────────────────────┘

siply> _

One-shot Mode

Run a single task and exit. Good for scripts and CI:

$ siply run --task "add error handling to auth.go"
◆ Reading auth.go...
◆ Proposed edit: wrap GetUser() in error check
◆ Apply? [y/n]

Tool Transparency

Every tool call is shown before execution. siply will never silently edit a file, run a command, or make a network request without telling you first.

# Example: siply asking permission
⚠ TOOL: write_file
path: src/auth/handler.go
action: add error handling to GetUser()

[A]pply [S]kip [V]iew diff [Q]uit

Providers & Models

siply supports multiple AI providers. Bring your own API keys:

$ siply config set anthropic_key sk-ant-...
$ siply config set openai_key sk-...
$ siply config set provider anthropic
$ siply config set model claude-sonnet-4-5

Supported providers: anthropic, openai, ollama, openrouter

Plugins (Alpha)

Install YAML plugins to extend siply's behaviour:

$ siply plugin install go-reviewer
$ siply plugin list
[ Found a bug? ]

siply is in Private Alpha. Bugs are expected — and valuable.