uptonica

The Uptonica command-line client for developers, agencies, and anyone automating their workspace — one binary, scope decided by the token you configure, not by which command you type.

Install

pip install uptonica   # or: uv tool install uptonica

Get a token

Go to Settings -> API Tokens in your Uptonica workspace (https://app.uptonica.com/account/api-tokens), pick "Terminal access", choose which workspace(s) and areas it should reach, and copy it.

uptonica config set-token

Use it

uptonica whoami
uptonica tenant use my-store          # set a default so you don't repeat --tenant
uptonica tools --search contact       # find a tool without scrolling the whole catalog
uptonica tools --show catalog.product.get   # see its full description + parameters
uptonica call catalog.stats.summary
uptonica call crm.contact.create_task --arg title="Follow up" --arg priority=2
uptonica ask "quanto ho venduto questo mese?"

If your token reaches more than one workspace, --tenant on any command overrides the default for that one call.

A write tool that needs confirmation returns a confirmation_token; re-run the same command with --confirm <token> within ~15 minutes to actually apply it. --dry-run previews a write without executing it. A tool name that doesn't exist gets a "did you mean" suggestion instead of a bare error.

Ask in natural language

uptonica ask "<message>" skips the tool catalog entirely — Lia (the same assistant behind chat and the mobile app) reads your request and picks the tool(s) herself, with the same per-tool permissions she already has everywhere else. A workspace's conversation continues across calls by default, so a follow-up like uptonica ask "sì" answers whatever Lia just asked (she always asks before a write, same as chat). Use --new to start a fresh thread, or --conversation <uuid> to pick a specific one.

Run uptonica with no arguments (or uptonica ask with no message) to open an interactive session instead — one process for the whole conversation, with /workspace to list or switch workspaces, /new for a fresh thread, and /help for the rest. Ctrl+D exits.

For AI agents

If you're an agent (Claude Code, Codex, or anything else) about to drive this CLI on someone's behalf, read AGENTS.md first — discovery order, how to handle a multi-workspace token, and the dry-run/confirm flow for writes.

Claude Code users: this repo is also a plugin marketplace, so you don't need to clone anything to get that guidance loaded automatically:

/plugin marketplace add tonic-tech/uptonica-cli
/plugin install uptonica@uptonica-cli

Status

Actively developed — v0.2.0, built directly on the same tool API that powers Uptonica's in-app assistant. See the repo issues for what's still open.