Gestura.appgestura.app

User documentation

First Workflow Quickstart

This quickstart is designed to give you one real success path. You will initialize Gestura, connect a simple MCP tool, and complete a request using either voice or chat.

Before You Begin

  • Gestura installed (see Installation Guide)
  • A working microphone
  • Optional: An MCP server running locally

Step 1: Initialize Gestura

Create your local config and confirm the CLI is available. This gives you a safe baseline before you tune providers, permissions, or tools.

# Create configuration directory and default config.yaml
gestura init

# This creates ~/.gestura/config.yaml

Step 2: Connect an MCP Server

Gestura becomes much more useful when it can act on files and other systems. A filesystem MCP server is a practical first connection.

# Add a server via CLI
gestura mcp add --name "local-files" --command "npx" --args "-y @modelcontextprotocol/server-filesystem /Users/me/Documents"

# Or edit config.yaml manually to add it under 'mcp_servers'

If you already use project-specific tools, you can return later and choose different MCP servers or scopes.

Step 3: Start an Interaction

Choose the interaction surface that feels most natural for your first run.

# Start listening (default wake word: "Gestura")
gestura listen

# Or try text-based chat
gestura chat

The desktop app is equally valid here. If you prefer the GUI, use the same basic flow there and keep the CLI for setup and troubleshooting.

Step 4: Ask for a Real Task

Try a request that uses the filesystem MCP server:

"Gestura, list the files in my documents folder."

The agent will route your request to the local-files MCP server, execute the tool, and speak the result.

Step 5: Confirm It Worked

  • You hear or see a result.
  • The MCP server shows connected.
  • Gestura stays responsive for a follow-up question.

Troubleshooting

Wake Word

If it doesn't trigger, try adjusting your microphone sensitivity or switching to "Push-to-Talk" with the configured hotkey (default: Ctrl+Space).

MCP Connection

Use gestura mcp status to verify that your servers are connected and healthy.

What to do next

© 2026 Gestura AI LLC. All rights reserved.