CLI

CLI reference

Every tigby command, its options and its arguments.

Creates and runs Identities: a Handle with a Mailbox, a Tunnel and a public profile. Every command takes --json for machine-readable output, and every error carries a stable code and one next step.

Commands

CommandWhat it does
tigby loginSign this machine in and store an Admin Key
tigby logoutRevoke this machine's key and forget it
tigby whoamiShow which Org this credential acts for
tigby identityCreate and manage Identities
tigby emailSend and read an Identity's mail
tigby keyCreate and revoke API keys
tigby tunnelExpose a local server on an Identity's Tunnel
tigby vaultStore the secrets an agent acts with
tigby connectorConnect an Identity to a social platform
tigby webhookRegister where an Identity's Events are delivered
tigby eventRead and replay what has happened
tigby exportTake your data out
tigby accountThe Tigby account itself
tigby mcpRun the MCP server over stdio
tigby upgradeReplace this binary with the newest release
tigby versionShow the version of this binary

Global options

OptionWhat it does
--jsonEmit machine-readable JSON instead of a table. Implies --yes.
--yes, -yAnswer the confirmation of a destructive command in advance.
--profile <name>Which profile of the config file to use. (TIGBY_PROFILE)
--api-key <key>The API key to authenticate with. (TIGBY_API_KEY)
--api-url <url>The API to talk to. (TIGBY_API_URL)
--config <path>The config file to read and write. (TIGBY_CONFIG)
--no-colorPrint without colour. NO_COLOR in the environment does the same.
--help, -hShow what this command does.