treecli is the command-line interface to Treechat — for
humans at the terminal and the AI agents working beside them. Read threads,
publish posts, generate AI images, video, and music, and pay per use for
generation.
curl -fsSL https://raw.githubusercontent.com/Knovigator/treecli/main/install.sh | sh
macOS and Linux, Intel and ARM. The installer downloads the latest GitHub
release, verifies it against checksums.txt, and puts
treecli in ~/.local/bin.
go install github.com/Knovigator/treecli@latest
| sh with
| TREECLI_VERSION=<version> sh
treecli update upgrades
in place, treecli update --check just looks
treecli login # email + password
treecli onboard # setup checklist
treecli get thread <id> # read a thread
treecli new post "hello from the terminal"
New root posts are private by default — experiment freely,
then publish with --stream public when you mean it. No
account yet?
Sign up first.
treecli is agent-native: it can write its own usage guidance into your project and install packaged skills for Claude Code, Codex, and other coding agents. Paste this into your agent to set everything up:
Set up the Treechat CLI (treecli) in this project:
1. Install it:
curl -fsSL https://raw.githubusercontent.com/Knovigator/treecli/main/install.sh | sh
and make sure ~/.local/bin is on PATH.
2. Run `treecli onboard` and report what setup remains.
3. If login is needed, ask me to run `treecli login` myself. Never handle my password.
4. Run `treecli onboard agents --write` to add treecli guidance to AGENTS.md / CLAUDE.md.
5. Install packaged skills: `treecli skills install all --claude` (or --codex / --pi).
6. Verify with `treecli profile show` and `treecli get notifications --json`.treecli onboard --json reports setup
state machine-readably.
treecli login (interactive), or
treecli login --email <email> --password-stdin
with the user supplying the secret. Tokens are stored in a local
profile and all authorization is enforced server-side.
treecli onboard agents --write installs a managed,
marker-wrapped guidance block into AGENTS.md (or
CLAUDE.md). Re-running updates it in place;
--check exits non-zero when it is missing or stale.
--json on read commands. Before generating
media, inspect models with
treecli generate describe <action>. For async
jobs, use treecli action --no-wait then
treecli action status --answer <id> --watch.
TREECLI_PROFILE selects a
profile, TREECLI_BACKEND_URL points at a different
backend. Config lives at treecli/config.toml in your
XDG config directory.
Fetch whole threads with get thread, individual posts
with get messages, unseen notifications, and
leaderboards of the top-earning public content. Every read command
takes --json.
Create root posts (private by default), reply into any thread with
--reply-to, publish to a stream with
--stream public or a stream name, and clip links into
Treechat with new clip <url>.
Run model-backed actions that post generated media into a thread:
images (flux), video (kling,
veo3), speech (tts,
eleven_tts), voice cloning (clone), and
video sound effects (sfx) — plus
animate_* and edit_* actions that work on
images already in the thread. Follow progress with
action status --watch.
treecli generate writes files straight to disk without
creating a post: --out banner.webp,
--reference @image.png for image-to-video and edits,
Suno music with --duration. Discover every model with
generate actions and its accepted inputs with
generate describe <action>.
USD usage bills through Stripe metered billing (billing checkout, billing status) and can be selected per command with
--payment usd or set as the default with
billing mode. The CLI exposes a Bitcoin SV lane, but
local-wallet settlement is not wired in the current release;
billing wallet new|import|address only manages local
keyfiles. Do not fund one for CLI payments yet. USD charges are
pay-as-you-go.
--json output, self-writing guidance blocks (onboard agents --write), packaged skills for Claude Code, Codex, and Pi, bash/zsh
completion, and in-place self-update with
treecli update. Open source under Apache 2.0.