a small
coding agent
for your terminal

The gate

Looking is free.
Changing asks.

The model works with six built-in tools. Anything that only reads runs immediately. Anything that changes your machine stops and waits for a y.

Write approvals show you the content for a new file, or a diff for an overwrite. Prompts resolve symlinks and flag targets outside the working directory. Files must be read before they can be edited.

Ctrl-C interrupts the current turn — it aborts the model call or the running tool without killing your session. If you want the gate out of the way entirely, scay yolo auto-approves everything. Use it with care.

Providers

Four backends,
talked to directly.

Every adapter is plain net/http against the provider's own API — no vendor SDKs to compile. Responses stream on all four, and transient failures retry automatically with backoff.

Environment variables override the config file, so CI and one-off shells work without touching your saved setup. Credentials are stored with 0600 permissions under ~/.config/scay.

The ChatGPT route relies on the Codex protocol and is explicitly experimental.

Inside the session

Everything is a
slash command.

There is no configuration file to learn first. Run scay, and it walks you through /auth and /model right there. Settings are remembered, so next time you just type.

Outside the session, the whole surface is four words:

scay          # the interactive session
scay yolo     # same, every action auto-approved
scay update   # self-update to the latest release
scay version  # print the version

MCP · optional

Bring your own tools.

scay is an MCP client. Plug in external tool servers over stdio or streamable HTTP and the model uses them like built-ins — behind the same approval gate.

Servers live in your global config, or in a per-project .mcp.json you can commit and share with the repo.

/mcp add fs -- npx -y @modelcontextprotocol/server-filesystem .
/mcp tools        # connect and list what the model will see
/mcp add --project fs -- …       # shared via .mcp.json

Tools are namespaced mcp__server__tool. A server that fails to start degrades to a warning instead of taking the session down with it.