PixTwins CLI

Your digital twin, in the terminal.

Install

npm install -g pixtwins

Auth

pixtwins login        # opens browser
pixtwins whoami
pixtwins logout

Chat

pixtwins chat                   # interactive REPL
pixtwins chat "summarize today" # one-shot

# REPL slash commands: /new [title] /chats /use <id> /workspace <id> /agents /help /exit

Workspaces & chats

pixtwins workspace list | use <id> | current
pixtwins chats list | rename <id> <title> | delete <id>

Agents, memories, integrations, triggers, outputs

pixtwins agent list | show <id> | create | edit <id> | delete <id> | refine <id> | versions <id>
pixtwins memory list | add <text...> | delete <id> | graph
pixtwins integration list | toolkits | connect <slug> | disconnect <slug>
pixtwins trigger list | subscribe <toolkit> | delete <id>
pixtwins output list | download <id> [path] | share <id>

Billing & BYOK

pixtwins usage
pixtwins billing                # opens Stripe portal
pixtwins keys list | add <provider> | remove <provider> | test <provider>

Automations / workflows / skills / capabilities / bundles

pixtwins automation list | run <id> | logs <id>
pixtwins workflow list <chatId> | show <id> | runs <id>
pixtwins skill list | community | install <skillId> | rate <skillId> <stars>
pixtwins capability list | install <slugs...>
pixtwins bundle install <bundleId>

Visibility

pixtwins activity                 # recent trigger events
pixtwins report list

Global flags

| Flag | Behavior | |---|---| | --workspace <id> | Override the default workspace for one invocation | | --json | Emit JSON lines (also auto-enabled when stdout is piped) | | --verbose | Show extra detail (chat command only) |

JSON output schema

Every command in --json mode emits a single JSON line with this shape:

{ "type": "<commandName>", "data": <result> }

Or on failure:

{ "type": "<commandName>", "error": { "message": "...", "code": "<CODE>" } }

Error codes: AUTH_EXPIRED, PERMISSION_DENIED, NOT_FOUND, SERVER_ERROR, NETWORK, VALIDATION.

Exit codes

0 success · 1 user error (auth, permission, validation, not-found) · 2 server error · 3 network unreachable.

License

MIT