CLI Command Reference

Syntax, options and examples for all yeero CLI subcommands.

Command Overview

Command	Description
`yeero start`	Start the background daemon service
`yeero stop`	Stop the daemon or all yeero processes
`yeero restart`	Restart the daemon
`yeero status`	Show daemon status
`yeero login`	Log in with email verification code
`yeero logout`	Log out
`yeero whoami`	Show current account
`yeero chat`	Start an AI conversation (TUI / plain / one-shot)
`yeero chats`	List conversations and folders
`yeero models`	List available AI models
`yeero tools`	List available tools
`yeero app`	Manage Python AI apps
`yeero config`	Manage local configuration
`yeero update`	Check for and install CLI updates

Global Options

These options apply to all subcommands:

Option	Description
`--lang <LANG>`	Temporarily override the UI language (`zh` or `en`), without writing to config
`--log-level <LEVEL>`	Log level: `trace` \| `debug` \| `info` \| `warn` \| `error`
`-h, --help`	Show help information
`-V, --version`	Print version

yeero start

Start the background daemon HTTP service. Most commands start the daemon automatically on demand, so you usually do not need to run this manually.

yeero start [OPTIONS]

Option	Default	Description
`-p, --port <PORT>`	`3000`	Listen port
`--host <HOST>`	`127.0.0.1`	Listen address
`-d, --detach`	—	Run in background and return immediately after spawning

# Foreground start (logs printed to terminal)
yeero start

# Background start
yeero start --detach

# Custom port
yeero start --port 8080 --detach

yeero stop

Stop the daemon service.

yeero stop [OPTIONS]

Option	Description
`-f, --force`	Force stop without waiting for graceful shutdown
`--all`	Stop all yeero processes (including chat / app run / TUI, implies force kill)

yeero stop
yeero stop --force
yeero stop --all

yeero status

Show whether the daemon is running and on which port.

yeero status

yeero restart

Restart the background daemon: stop any running daemon, then relaunch it in detached mode. If the daemon is not running, it starts directly.

yeero restart [OPTIONS]

Option	Description
`-f, --force`	Force stop the old process without waiting for graceful shutdown

# Graceful restart
yeero restart

# Force restart
yeero restart --force

Log in with email verification code. OAuth is not supported in the CLI; use the web or desktop app for Google / GitHub login.

yeero login [OPTIONS]

Option	Description
`--email <EMAIL>`	Pre-fill email and skip interactive input
`--code <CODE>`	Pre-fill verification code and skip sending step (requires `--email`)

# Interactive login
yeero login

# Non-interactive login (good for CI / scripts)
yeero login --email [email protected] --code 123456

yeero logout

Log out the current account and clear the local token.

yeero logout

yeero whoami

Print current account information in JSON format. Shows a hint when not logged in.

yeero whoami

yeero chat

Start an AI conversation. Supports TUI full-screen mode, plain multi-turn mode and one-shot mode. See Chat In Depth for details.

yeero chat [MESSAGE] [OPTIONS]

Common options:

Option	Description
`MESSAGE`	Initial message (optional; omit to start an empty session)
`--plain`	Use plain line mode (instead of TUI)
`--oneshot`	Send a message and exit immediately; good for scripts / pipes
`-m, --model <MODEL>`	Model ID; repeat for multi-model parallel calls
`--chat-id <ID>`	Continue an existing conversation
`--branch-id <ID>`	Continue an existing branch
`--folder-id <ID>`	Folder for the new conversation
`--tool <ID>`	Enable a tool (repeatable)
`--user-file <PATH>`	Attach a local file (repeatable)
`--use-knowledge`	Enable knowledge base retrieval

yeero chat "Explain vector databases"
yeero chat -m gpt-4o -m claude-3-5-sonnet "Compare the two responses"
yeero chat --oneshot "What is today's date?"

yeero chats

List conversations and folders for the current account.

yeero chats [OPTIONS]

Option	Default	Description
`--folder-id <ID>`	`0` (root)	Parent folder ID
`--name <KEYWORD>`	—	Fuzzy search by name
`--pinned`	—	Only return pinned items
`--order <ORDER>`	`DEFAULT`	`DEFAULT` or `EARLIEST`
`--page <N>`	`1`	Page number
`--size <N>`	`50`	Items per page (1–200)
`--json`	—	Output as JSON (script-friendly)

yeero chats
yeero chats --name "architecture" --json

yeero models

List AI models available to the current account.

yeero models [OPTIONS]

Option	Description
`--keyword <KW>`	Fuzzy search by name
`--free`	Show only free models
`--input-modalities <LIST>`	Filter by input capabilities, comma-separated (e.g. `text,image`)
`--output-modalities <LIST>`	Filter by output capabilities, comma-separated (e.g. `text,audio`)
`--page / --size`	Pagination options
`--json`	Output as JSON

yeero models
yeero models --keyword claude --free
yeero models --output-modalities image --json

yeero tools

List tools available to the current account.

yeero tools [OPTIONS]

Option	Description
`--keyword <KW>`	Fuzzy search by ID / name / description
`--json`	Output as JSON

yeero tools
yeero tools --keyword search --json

yeero app

Manage Python AI apps. Contains multiple subcommands; see AI Apps for details.

Subcommand	Description
`yeero app create`	Create a new Python app
`yeero app list`	List all apps
`yeero app show`	Show app details
`yeero app save`	Save local file as a new version
`yeero app versions`	List version history
`yeero app version-show`	Show details of a specific version
`yeero app rollback`	Roll back to a specific version
`yeero app generate`	AI code generation (single-turn)
`yeero app discuss`	AI multi-turn discussion REPL
`yeero app run`	Run an app
`yeero app stop`	Stop a running app
`yeero app uninstall`	Uninstall a locally installed app

yeero config

Manage local configuration. See Config & Daemon for details.

Subcommand	Description
`yeero config get-lang`	Show current UI language
`yeero config set-lang <LANG>`	Set UI language (`zh` or `en`)
`yeero config get-default-model`	Show current default model
`yeero config set-default-model <MODEL>`	Set default model
`yeero config unset-default-model`	Clear default model setting
`yeero config add-to-path`	Add yeero directory to system PATH
`yeero config get-path`	Show existing yeero entries in PATH
`yeero config clear-path`	Remove all yeero entries from PATH

yeero update

Check for and automatically install the latest CLI version.

yeero update [OPTIONS]

Option	Description
`--check`	Only check for updates, do not download or install

# Check and install automatically
yeero update

# Check only, do not install
yeero update --check

💡 Auto update check

Every time you run a CLI command, the CLI silently checks for updates in the background (cached for 1 hour). When a new version is available, it prints a single yellow hint without blocking the current command.