Deep customization: API keys, model selection, workspace config, memory tuning, and automation.
While your agent helps you set up API keys during onboarding, you can manually configure multiple providers for different use cases:
API keys are stored encrypted in your macOS Keychain. They're never synced or sent to Pinchr servers — only directly to the AI provider APIs.
Never share your API keys. If a key is leaked, revoke it immediately from your provider's dashboard and add a new one in Pinchr.
Choose which AI model your main agent and sub-agents use:
Advanced users can override models per agent in Settings → Agents. You can also set fallback models if your primary provider has an outage.
Customize how Pinchr organizes your work:
Set a default folder where your agent saves files, logs, and automation scripts.
Dark mode (default), light mode, or system sync. Adjust font size, sidebar width, and chat density.
Customize all keybindings in Settings → Keyboard. Supports vim-style bindings and chord sequences.
Power users can define custom agent behaviors with an AGENTS.md file in their workspace root:
Place this file in your workspace root. Pinchr loads it automatically on startup. Changes take effect immediately — no restart required.
Most users manage agents through the Settings UI. AGENTS.md is for version-controlled workspaces or teams sharing agent configs.
Fine-tune how your agent remembers and recalls information:
Choose how long your agent keeps conversation history and task context:
Enable embedding-based search to find relevant context from old conversations. Requires OpenAI API key.
Your agent automatically creates memory notes about your preferences. Review and edit them in Settings → Memory.
Memory data is stored locally in ~/.pinchr/memory/. You can back it up or sync it via iCloud/Dropbox symlinks.
Set up recurring automations that run on a schedule:
Create cron jobs by telling your agent: "Run [task] every [schedule]". Your agent creates the automation and shows you a preview before enabling it.
Cron jobs run even when Pinchr is closed (via macOS background daemon). View logs and history in Settings → Automations.
For scripts, MCP servers, and automations, you can define environment variables:
Set these in Settings → Environment. Your agent can reference them in automations, and MCP servers inherit them automatically.
Back up your Pinchr configuration or sync it across devices:
Includes: agent configs, automations, keyboard shortcuts, MCP servers. Excludes: API keys, memory data.
Restores settings from a previously exported file. Your agent will prompt for any missing API keys.
A command-line interface for Pinchr is in development. It will let you:
Join Discord for early access when the CLI launches.
Join our community or reach out — we're here to help.