CLI Setup

The sibyl CLI is the fastest way to recall memory, capture learnings, manage tasks, and create API keys for MCP clients.

Install

Homebrew is the preferred install path on macOS and Linux:

brew install hyperb1iss/tap/sibyl

For remote-only installs, the shell installer skips the local daemon and web UI:

curl -fsSL https://raw.githubusercontent.com/hyperb1iss/sibyl/main/install.sh | sh -s -- --remote

If your environment distributes the Python package directly, install the CLI package with your Python tool of choice:

python -m pip install sibyl-dev

Point The CLI At Your Server

A fresh Sibyl CLI defaults to http://localhost:3334, so if you run Sibyl locally with sibyl up you can usually skip ahead to Daily Checks. sibyl up does not change your CLI's active context, though, so if you previously pointed it at a remote server, switch back to the local context (it defaults to localhost, so no URL is needed):

sibyl init --local        # or: sibyl config context use local
sibyl doctor

To point the CLI at a remote or shared server instead:

sibyl init --remote https://your-sibyl-host
sibyl auth login

sibyl auth login opens the browser sign-in flow. On a team server behind corporate SSO, that browser flow uses the same OIDC provider as the web app.

For headless terminals, print the login URL instead:

sibyl auth login --no-browser

After login, confirm the active context:

sibyl auth status
sibyl whoami

Create An API Key

MCP clients and automation should use API keys, not copied browser cookies. In the web UI, open Settings, Security, API Keys and create a key with the right scope. From the CLI:

sibyl auth api-key create --name "claude-code" --scopes mcp

For script access to the REST API, use explicit API scopes:

sibyl auth api-key create --name "ci-readonly" \
  --scopes api:read \
  --expires-days 90

The full key is shown once. Store it in your password manager or client secret store immediately.

Daily Checks

sibyl context "current project context"
sibyl remember "Deployment gotcha" "The restore drill needs the export PVC mounted"
sibyl task list --status doing

If a command says auth is required, run sibyl auth login again. If an API key fails, revoke it in Settings and create a new scoped key.