Install satelle

satelle installs as two static binaries: satelle, the CLI, and satelled, the local project page. No cgo, no runtime dependencies.

Downloads the latest release of both binaries for your platform, sha256-verifies them, and installs to ~/.local/bin (override with SATELLE_INSTALL_DIR).

curl -fsSL https://github.com/bobmcallan/satelle/releases/latest/download/install.sh | sh

Clone the repository and build with Go. make install builds satelle and satelled into ~/.local/bin (override with PREFIX).

git clone https://github.com/bobmcallan/satelle.git
cd satelle
make install

Already installed? satelle update self-updates in place — it resolves the latest release, sha256-verifies it, replaces the binaries, and restarts the background service if it is running.

satelle update

satelle update --check reports availability without installing.

satelle update --check

Online agents (Claude, Grok) connect to the hosted satelle MCP server over Streamable HTTP. Add the URL — the agent discovers OAuth, opens a browser sign-in on this host, and calls tools with its own access token. No API token goes in the config.

https://satelle.dev/mcp

Claude Code:

claude mcp add --transport http satelle https://satelle.dev/mcp

Or paste into mcp.json (Claude Code / Grok):

{
  "mcpServers": {
    "satelle": {
      "type": "http",
      "url": "https://satelle.dev/mcp"
    }
  }
}

For unattended use, create a personal access token under Settings → MCP.

Quickstart

Set satelle up in a repo and raise your first story. A story needs a body and numbered acceptance criteria: a reviewer judges it before it is created.

cd your-repo
satelle init              # .satelle/ config and local database; registers the repo
satelle story create --title "Add a /healthz endpoint" --category feature \
  --body "The service has no health check." \
  --acceptance "1. GET /healthz returns 200 with the build version."
satelle status            # config, database, and story counts
satelle service install   # background project page at http://127.0.0.1:8787

Prefer a foreground process? Run satelled in another terminal instead of satelle service install.