Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mains.dev/llms.txt

Use this file to discover all available pages before exploring further.

Mains is a local-first desktop application. Your data stays on your machine, and agent conversations go directly to your configured provider — never through Mains’s servers.

​
What Stays Local

DataStorage
Agent sessionsStored locally with full run history
Synced entitiesIssues, tasks, pull requests fetched from connected services
Workspace filesGit worktrees on your local filesystem
Your database is stored at:
  • macOS: ~/Library/Application Support/mains/mains.db

​
Credentials

API tokens and OAuth credentials for connected services (GitHub, Linear, Jira, etc.) are stored encrypted in the local database. Tokens are never sent to Mains’s infrastructure.

​
No Telemetry

Mains does not include analytics, telemetry, or tracking services. No usage data is collected or transmitted to external services.

​
Agent Communication

When you run an agent session, messages are sent directly from your machine to the agent provider:
  • Claude Code — communicates with Anthropic’s API using your API key or Claude account
  • GitHub Copilot — communicates with GitHub’s API using your Copilot subscription
  • OpenAI Codex — communicates with OpenAI’s API using your Codex account
Mains does not proxy, log, or inspect these communications. Your provider’s privacy policy governs how they handle your data.

​
Connected Services

When you sync data from GitHub, Linear, Jira, or other services, Mains fetches content using the credentials you provide and stores it locally. Synced data is used only for local search and agent context — it is never shared externally.