Tetra CLI
Tetra is an intelligent life organizer — "Tetris for time." It helps you align your time and money with what you actually value, through hierarchical values, goals, and events, plus the analytics to see where it all goes. Learn more or create a free account at tetraseneca.com.
This package is the standalone command-line client for Tetra — manage your values, goals, events, and time from your terminal or from any LLM agent (Claude Code, OpenClaw, and other tool-using assistants).
It talks to the Tetra API over HTTPS using your API key. It has no access to the Tetra backend internals — it only does what your account can do.
Install
pip install tetra-cli
This installs the tetra-cli command. It depends only on public packages
(httpx, typer, click).
1. Get an API key
In the Tetra web app, go to Settings → API Keys → Create key. Choose the scopes your agent needs (you can create a read-only key, or grant specific writes):
| Scope | Lets the agent… |
|---|---|
read |
read everything in your account |
events:write |
record / edit / delete events |
goals:write |
create / edit / delete goals |
values:write |
create / edit / delete values |
tags:write |
create / edit / merge tags |
The key (tetra_…) is shown once. Copy it then.
Keep your API key secret. It grants the same access as logging in — anyone who has it can act as you, just like your password. Store it in your agent's secrets/credential store, never paste it into shared chats or commit it to git, and revoke it from Settings → API Keys if it may have leaked.
2. Configure the CLI
Save the key once (it's stored in ~/.tetra/cli_config.json):
tetra-cli auth login tetra_your_key_here
# defaults to https://api.tetraseneca.com; pass --url to target another server
tetra-cli auth status # confirm who you're authenticated as
Or skip the saved config and use environment variables (handy for agents / CI), which always take precedence:
export TETRA_API_KEY=tetra_your_key_here
export TETRA_API_URL=http://localhost:8000 # optional; only to target a local backend (defaults to prod)
3. Install the agent skill (optional)
To let an AI coding agent drive Tetra for you, install the bundled skill into
its skills directory (defaults to Claude Code's ~/.claude/skills):
tetra-cli skill install # -> ~/.claude/skills/tetra-cli/SKILL.md
tetra-cli skill install --dir /path/to/other/agent/skills # another agent
tetra-cli skill show # print the skill without installing
4. Use it
Goals and values are addressed by their hierarchical name — no UID hunting:
tetra-cli values list
tetra-cli goals list
tetra-cli goals get "Exercise > Weight Training"
tetra-cli events create 2026-06-10 --goal "Exercise > Weight Training" \
--duration-minutes 45 --description "Bench + accessories"
tetra-cli events list --on-date 2026-06-10
tetra-cli dashboard week-snapshot
Every command supports --help. Output is JSON; put --pretty before the
command group (tetra-cli --pretty goals list) to indent it for reading.
Full command surface
The CLI mirrors everything you can do in the Tetra web app — your agent can
act on your behalf anywhere you can act yourself. Commands are generated from
the same operation registry the app uses, so the surface never drifts behind
the product (a parity check in CI fails if a user-facing endpoint has no
command). Run tetra-cli --help to browse the groups:
| Group | What it covers |
|---|---|
guide |
the Tetra ontology — what values, goals, and events mean |
values, goals, events, tags |
the core model: create/read/update/delete, hierarchy moves, metrics, bulk edits |
dashboard, analysis, data |
week/day analytics, time & spending breakdowns, full export & CSV import |
summary, ai |
day/week/month/year summaries, natural-language questions to the assistant, AI settings |
scratches, notifications, links |
quick capture, reminders, web links and places on events/goals |
photos, foods, screen |
photos, food search, the Mac app's recorded computer time |
gamification, awards, xp, capacity, cosmetics, offset |
XP/level/streak, credits, gems, item shop, slot capacity, cosmetics, credit offsets against membership |
social, peers, calls |
groups, sharing, skill trees & Arena blueprints, connections, live-call status |
conversations, messages |
DMs, group chats, and the shared AI thread (messages subscribe streams it live) |
outcome-schemas |
reusable metric templates |
accounts, api-keys, onboarding, watch |
your profile, key management, onboarding, Apple Watch pairing |
archive, stripe |
restore soft-deleted items, manage your subscription |
strava, plaid, issues |
activity & bank integrations, bug reports |
auth, skill |
save/inspect the API key, install the agent skill |
Admin/superuser endpoints are intentionally excluded — a key only ever reaches your own account's data.
Using it from an LLM agent
Point your agent's shell at the tetra-cli binary with TETRA_API_KEY set in
its environment. The agent can then drive data entry, edits, and analysis on
your account. For a Model-Context-Protocol integration (Claude Desktop, etc.),
see the companion tetra-mcp package, which reads the same
~/.tetra/cli_config.json.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for tetra-cli 0.13.37
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| tetra_cli-0.13.37.tar.gz | 280.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tetra_cli-0.13.37-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 556.9 kB
Release files / tetra_cli-0.13.37.tar.gz
| Download URL | tetra_cli-0.13.37.tar.gz |
|---|---|
| Size | 280.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
78d78ae4c8b05e419a1d33bb3d2ac3ba0a8d7e3ec92d98689384d6fdf78d3560
|
|
BLAKE2b-256 checksum How to use checksums |
057ff55292255df5b79f72c8bea791ab257ce86c4e94f21363b11d8f77cb3bc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / tetra_cli-0.13.37-py3-none-any.whl
| Download URL | tetra_cli-0.13.37-py3-none-any.whl |
|---|---|
| Size | 276.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc09db525f5cd44056c3c71bd9b9fe1ff74d4591a276c2d723dacf2d4ed0e6ad
|
|
BLAKE2b-256 checksum How to use checksums |
efd86ec8ca505e0eb45ab8a68b25e95ac1b0e48c46b85eace0e3b79e2bd8ca31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for tetra-cli 0.13.37
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
