Config & Daemon

Use yeero config to manage language, default model, and PATH settings. Use yeero start / stop / status to control the background Daemon service.

Config Subcommands

yeero config provides the following subcommands, all of which are pure local file operations — no Daemon required:

Language Settings

yeero CLI supports two UI languages: Chinese (zh) and English (en).

# Show current language
yeero config get-lang

# Set to English
yeero config set-lang en

# Set to Chinese
yeero config set-lang zh

# Run without argument for interactive input
yeero config set-lang

The language setting is persisted in config.toml, isolated by build environment (dev / pre / prod).

Default Model

The default model is used by yeero chat, yeero app generate, and other commands when --model is not specified.

# Show current default model
yeero config get-default-model

# Set a default model
yeero config set-default-model gpt-4o

# Run without argument for interactive input
yeero config set-default-model

# Clear the default model (revert to built-in default)
yeero config unset-default-model

You can get the full list of available model IDs with yeero models.

Add yeero to PATH

If your terminal cannot find the yeero command after installation, run the following to configure PATH automatically:

# Add to user-level PATH (recommended)
yeero config add-to-path

# Add to system-level PATH (requires admin/sudo)
yeero config add-to-path --system

# Preview without making changes
yeero config add-to-path --dry-run

# Remove from PATH
yeero config add-to-path --remove

Check PATH Configuration

Use config get-path to view the current yeero executable directory and any yeero entries present in both user-level and system-level PATH:

yeero config get-path

Example output:

current yeero directory: /usr/local/bin
user PATH yeero entries: /usr/local/bin
system PATH: no yeero entries found

Remove yeero from PATH

config clear-path removes all yeero-related entries from PATH (without appending a new path). Useful for uninstalling or relocating:

# Remove from user-level PATH (default)
yeero config clear-path

# Remove from system-level PATH (requires admin/sudo)
yeero config clear-path --system

# Preview without making changes
yeero config clear-path --dry-run

Daemon Overview

Most yeero CLI features (chat, AI apps, etc.) rely on a background Daemon process. The Daemon runs as a local HTTP service, handling communication with cloud APIs, managing conversation context, and controlling AI app lifecycles.

Under normal circumstances, the Daemon starts automatically when you run any network-requiring command. You can also manage it manually:

Start the Daemon

# Start Daemon in background
yeero start

# Specify a listening port (default: auto-assigned)
yeero start --port 7700

# Run in foreground (for debugging)
yeero start --foreground

Stop the Daemon

yeero stop

This command sends a termination signal to the running Daemon for a graceful shutdown.

Check Status

yeero status

Example output:

Daemon running on port 7700
Version: 0.1.0

If the Daemon is not running, it will display Daemon not running.

Config File Location

yeero's config file config.toml is stored per build environment:

The config file is in TOML format and currently supports the following fields:

# UI language: zh or en
lang = "en"

# Default model ID (optional)
default_model = "gpt-4o"