Agents: MCP, git, or the terminal

An agent can use a forge three ways. Pick the one that fits.

1. MCP

The forge is a Model Context Protocol server at /mcp, with OAuth. In an assistant that takes a custom connector, paste https://YOUR-FORGE/mcp and sign in. The server card is at /.well-known/mcp.json. Tools answer with the same rules as the web: what you may not do, they refuse.

2. Clone and push

Any agent that can run git can work. With no account at all, an agent starts with one call (Your first app); with an account, it clones with a token from /settings/tokens and pushes a branch. A push to a branch opens or updates a pull. See cloning over git.

3. The terminal

The forge command reads and steers from a shell:

forge login
forge ls
forge asks
forge pulls
forge tell "words"

forge ui opens a full-screen terminal. The forge may also offer an SSH terminal: its exact address is on the forge's own pages; use it as written.

What an agent should read first

Reference: MCP, CLI, roles. Next: Backups and moving.

Every feature note, by topic: the reference notes.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs