# Synti

> Documentation for Synti — a local-first desktop AI agent.

## Docs

- [Automations](https://docs.synti.co/automations/overview.md): Trigger shell commands or new agent sessions automatically when events happen inside Synti.
- [API Discovery](https://docs.synti.co/browser/api-discovery.md): How the Synti agent finds a web app's backend endpoints and calls them directly instead of clicking through the UI.
- [Browser Examples](https://docs.synti.co/browser/examples.md): Practical prompts and workflows for driving the Synti browser — logins, forms, extraction, network inspection, and multi-step tasks.
- [Browser Automation](https://docs.synti.co/browser/overview.md): Let the Synti agent drive a real browser to navigate, fill forms, extract data, and inspect network traffic.
- [Conversations](https://docs.synti.co/core-concepts/conversations.md): How Synti organizes work as resumable conversations, and how to manage them with statuses, labels, and workspaces.
- [Interactions](https://docs.synti.co/core-concepts/interactions.md): The ways you communicate with the Synti agent — mentions, attachments, streaming responses, and steering or queuing follow-ups.
- [Permissions](https://docs.synti.co/core-concepts/permissions.md): How Synti's permission modes and rules control exactly what the agent is allowed to do.
- [Working Directory](https://docs.synti.co/core-concepts/working-directory.md): How the working directory gives the Synti agent direct, local filesystem access to a project folder.
- [Colors](https://docs.synti.co/customisation/colors.md): How to assign colors to labels, statuses, and other entities in Synti using system tokens or custom values.
- [Icons](https://docs.synti.co/customisation/icons.md): Give sources, skills, and statuses a visual identity with emoji, image files, or theme-aware SVGs.
- [Themes](https://docs.synti.co/customisation/themes.md): How Synti's semantic color tokens, light and dark modes, and workspace theme overrides fit together.
- [Installation](https://docs.synti.co/getting-started/installation.md): Platform requirements and step-by-step instructions for installing Synti on macOS, Windows, and Linux.
- [Introduction](https://docs.synti.co/getting-started/introduction.md): What Synti is, who it's for, and the core ideas behind the local-first desktop agent app.
- [Connect to Anything](https://docs.synti.co/go-further/connect-to-anything.md): Reach services that lack a native integration by routing Synti through an API aggregator.
- [Deep Links](https://docs.synti.co/go-further/deeplinks.md): Open Synti and trigger actions from browsers, scripts, launchers, and other apps using the synti:// URL scheme.
- [Document Tools](https://docs.synti.co/go-further/document-tools.md): Read, convert, and create PDF, Word, Excel, PowerPoint, image, and calendar files directly in a session.
- [Performance & Token Optimization](https://docs.synti.co/go-further/performance.md): Reduce token usage on command-heavy sessions by compressing verbose output before it reaches the model.
- [Rich Output](https://docs.synti.co/go-further/rich-output.md): How Synti renders tables, spreadsheets, diagrams, HTML, PDFs, Markdown, and diffs inline instead of as raw text.
- [Sharing Conversations](https://docs.synti.co/go-further/sharing.md): Publish a conversation as a read-only web page, or fork it into another workspace.
- [Workspaces](https://docs.synti.co/go-further/workspaces.md): Keep separate configurations — sources, skills, statuses, sessions, and defaults — for different contexts.
- [Synti Documentation](https://docs.synti.co/index.md): A local-first desktop AI agent that connects to your tools, runs skills, and automates work on your machine.
- [Auto-Apply Rules](https://docs.synti.co/labels/auto-rules.md): Attach labels to a session automatically when your messages match a regular expression.
- [Labels](https://docs.synti.co/labels/overview.md): Organize sessions with additive, colored, optionally-typed tags arranged in a nested tree.
- [Lark / Feishu](https://docs.synti.co/messaging/lark.md): Connect a Lark or Feishu custom app to Synti for direct and group chats with interactive cards and rich text.
- [Messaging Integrations](https://docs.synti.co/messaging/overview.md): Reach the Synti agent from Telegram, WhatsApp, and Lark/Feishu, and drive sessions from your phone.
- [Telegram](https://docs.synti.co/messaging/telegram.md): Connect a Telegram bot to Synti so you can drive the agent from private chats on any device.
- [WhatsApp](https://docs.synti.co/messaging/whatsapp.md): Link WhatsApp to Synti with a QR scan and drive the agent from a self-chat or a second phone.
- [CLI Reference](https://docs.synti.co/reference/cli.md): Full command and flag reference for synti-cli, the terminal client for a Synti server.
- [Config File](https://docs.synti.co/reference/config/config-file.md): How Synti stores app settings in config.json, what each section means, and how to edit it safely.
- [Credentials](https://docs.synti.co/reference/config/credentials.md): How Synti encrypts API keys and tokens on disk, where they live, and how to inspect or reset them.
- [API Providers](https://docs.synti.co/reference/config/custom-endpoint.md): Choose a model provider or point Synti at a custom base URL, including OpenAI-compatible and self-hosted endpoints.
- [Environment Variables](https://docs.synti.co/reference/config/environment-variables.md): Every SYNTI_ environment variable Synti reads, what it controls, and how values take precedence.
- [LLM Connections](https://docs.synti.co/reference/config/llm-connections.md): Configure multiple model providers, set defaults, and control which connection each session uses.
- [Network Proxy](https://docs.synti.co/reference/config/network-proxy.md): Route Synti's traffic through an HTTP or HTTPS proxy and trust a corporate TLS-inspecting certificate.
- [Preferences](https://docs.synti.co/reference/config/preferences.md): Personal details Synti weaves into the agent's context, plus where appearance and language settings live.
- [Terminal Client](https://docs.synti.co/server/cli.md): Connect synti-cli to a running Synti server over WebSocket to send prompts and manage sessions from the shell.
- [Headless Server](https://docs.synti.co/server/headless.md): Run Synti as a token-authenticated WebSocket server for remote, programmatic, and always-on access.
- [Skills](https://docs.synti.co/skills/overview.md): Teach Synti's agent reusable procedures with markdown SKILL.md instruction files it can invoke on demand or automatically.
- [REST API Examples](https://docs.synti.co/sources/apis/curl-examples.md): Ready-to-adapt configurations for connecting common REST APIs to Synti's agent.
- [REST API Sources](https://docs.synti.co/sources/apis/overview.md): Connect Synti's agent to any HTTP service by configuring a base URL and authentication method.
- [Local Filesystem Sources](https://docs.synti.co/sources/local-filesystems.md): Bookmark folders on your machine so Synti's agent can read and reference them across conversations.
- [MCP Authentication](https://docs.synti.co/sources/mcp-servers/authentication.md): How Synti authenticates MCP servers and stores their credentials securely on your machine.
- [Connecting MCP Servers](https://docs.synti.co/sources/mcp-servers/connecting-servers.md): Step-by-step guide to adding, configuring, and managing MCP servers as sources in Synti.
- [MCP Servers](https://docs.synti.co/sources/mcp-servers/overview.md): Connect Synti's agent to external tools and services through the Model Context Protocol.
- [Sources](https://docs.synti.co/sources/overview.md): Connect Synti's agent to external tools, services, and folders through MCP servers, REST APIs, and local filesystems.
- [Customizing Statuses](https://docs.synti.co/statuses/customizing.md): Add, edit, reorder, and restyle workflow statuses for a workspace, by asking the agent or editing config directly.
- [Statuses](https://docs.synti.co/statuses/overview.md): Track where each session sits in your workflow with a single status drawn from open and closed states.