One-Shot Mode

One-shot mode runs a single prompt and exits, similar to bash -c:

meka "your prompt here"

The agent processes the prompt (including any tool calls), prints its response, and the process terminates. The session UUID is printed to stderr on exit.

Examples

# Simple question
meka "what is my current working directory?"

# File operations (requires write permission)
meka --permission write "create a file called notes.txt with today's date"

# Search
meka "find all TODO comments in this project"

# Web search
meka "search the web for the latest Rust release"

Combining with Other Flags

All configuration flags work in one-shot mode:

# Use a specific provider and model
meka --provider claude-oauth -m claude-sonnet-4-20250514 "explain this codebase"

# With write permission
meka --permission write "run 'cargo test' and summarize the results"

# Disable streaming
meka --no-stream "read README.md and summarize it"

Session Behavior

One-shot mode creates a new session for each invocation. The session UUID is printed to stderr when the run completes:

Session: 550e8400-e29b-41d4-a716-446655440000

You can resume this session later in interactive mode:

meka -s 550e8400-e29b-41d4-a716-446655440000