CLI Chat In Depth

Deep dive into yeero chat: plain multi-turn mode, one-shot mode, multi-model parallel, files & tools, knowledge base, media generation and sampling parameters.

Two Interaction Modes

Plain Multi-turn Mode (Default)

Running yeero chat enters plain multi-turn mode by default: type your message after the terminal prompt, press Enter to send, and the AI streams its reply. You can continue the conversation for as many turns as you like; type /exit or press Ctrl+C to quit.

# Start plain multi-turn (new conversation)
yeero chat

# Start with an initial message
yeero chat "Analyze this code snippet"

# Resume an existing conversation
yeero chat --chat-id 12345

One-shot Mode

Add --oneshot to send a single message and exit immediately. Great for scripts, pipes and CI:

# Print the AI response directly
yeero chat --oneshot "Summarize quantum computing in one sentence"

# Pipe input
cat error.log | yeero chat --plain --oneshot "Explain this error"

# Disable color output (good for pipes or log collection)
yeero chat --no-color --oneshot "Generate a JSON snippet"

Multi-model Parallel

Pass -m multiple times to send the same message to several models at once and compare their responses side by side:

yeero chat -m gpt-4o -m claude-3-5-sonnet "Which programming language is better for AI development?"
yeero chat -m deepseek-r1 -m gemini-2.5-pro "Solve this math problem: ..."

When no -m is given, the default model is used (set via yeero config set-default-model).

Session & Branch Management

# Find the conversation ID
yeero chats --name "last project"

# Continue that conversation
yeero chat --chat-id 98765 "Continue the previous discussion"

Files & Tools

File Attachments

Use --user-file to upload local files as attachments (repeatable for multiple files):

yeero chat --user-file ./report.pdf "Summarize the key points of this report"
yeero chat --user-file image1.png --user-file image2.png "Compare these two images"

Enable Tools

Use --tool to specify a tool ID (run yeero tools to see available tools):

yeero tools                            # list available tools
yeero chat --tool web_search "Any tech news today?"

Knowledge Base Retrieval

yeero chat --use-knowledge "Based on my past conversations, summarize my main technical interests"

Sampling Parameters

Fine-tune model generation behavior:

yeero chat --temperature 0.2 --reasoning-effort HIGH "Write a rigorous technical analysis"
yeero chat --temperature 1.5 "Give me a creative story opening"

Image Generation

Choose a model that supports image output (e.g. dall-e-3, gpt-image-1) and pass image parameters:

yeero chat -m dall-e-3 --image-aspect-ratio RATIO_16_9 --image-size SIZE_2K "A cyberpunk cityscape at night"

Audio Generation

Choose a model that supports audio output (e.g. gpt-4o-audio) and pass audio parameters:

yeero chat -m gpt-4o-audio --audio-voice NOVA --audio-format MP3 "Read this text aloud: ..."

Video Generation

Choose a model that supports video output and pass video parameters. Video generation is an async task; the CLI automatically polls for the result:

yeero chat -m wan-2.1 --video-aspect-ratio RATIO_16_9 --video-resolution P720 --video-duration 10 "A cat running across a meadow"