CLI Overview
The CLI is the fastest way to initialize Gestura, add tools, validate configuration, and run diagnostics. Even if you mainly use the GUI, the CLI gives you precise control over setup and recovery.
When to use the CLI
- Creating or validating your configuration.
- Adding or inspecting MCP servers.
- Inspecting knowledge items and context analysis.
- Starting a quick listen or chat session from the terminal.
- Running health checks when the desktop app feels wrong.
About gestura and gestura-app
The current docs surface two command names. gestura is used for interactive and workflow-oriented commands such as init, listen, chat, and mcp. gestura-app appears in the packaged install flow for health and verification commands such as --health and --test-audio.
If your install exposes only one of those names, run --help on the available command and follow that surface consistently.
The CLI workflow model
- Initialize or update config.
- Connect the tools or MCP servers you need.
- Start a listening or chat flow.
- Validate health and settings when something fails.