What is Intent?
Intent is a free desktop app for large-scale agent coordination for developers. More agents should mean more shipped, not more chaos, so Intent is built around spec-driven development and multi-agent orchestration that works across devices.
Set direction and decide outcomes, then watch coordinated agents build toward what you actually meant. Steer, monitor, and create from anywhere with the Intent mobile app.
Key Features
Task-focused workspaces
Work in tasks, not chat threads. Every task is a separate workspace with an isolated copy of your files, so agents never step on each other. Each workspace can run many agents, and you can run many workspaces in parallel, so scaling up your agents doesn’t mean scaling up the collisions.
Spec-driven development
Each workspace can start with a living spec that captures assumptions, requirements, and design decisions, and it keeps updating as the work evolves. That spec is the shared context every agent in the workspace works from, so they stay on plan instead of drifting toward their own guesses, and it doubles as a record of what was decided and why.
Multi-agent orchestration
Each workspace’s coordinator agent can break work into structured pieces and delegate to specialized sub-agents, deciding when implementers act and when to kick off verifiers. Agents also watch for changes and start the next task themselves, so the coordination keeps moving without you relaying every step.
Specialists
Agents come pre-configured for specific roles: coordinator, implementer, verifier, UI designer, PR reviewer, and more. Because every role can be delegated to, one workflow can span planning, building, and review without you stitching it together. Create your own specialists to encode your team’s conventions, review standards, or domain expertise into reusable roles that any agent can delegate to.
Bring your own agent
Because roles are swappable, you can mix providers per workspace, using one model to coordinate and another to verify. Works with Augment Auggie, Anthropic Claude Code, Google Antigravity, Grok Build, OpenAI Codex, OpenCode, Pi, and Unsloth as underlying providers, with models swappable between sessions and workspaces.
Multi-device support
Run remote machines and move workspaces between local and remote devices. Offload tasks like long test runs to a remote machine, then pick them back up locally when they’re done.
Intent mobile
The Intent mobile app for iPhone, iPad, and iPhone Duo is a remote control for Intent on your computer. Start new workspaces, chat with agents, answer their questions, and check on notes, diffs, terminals, and browser previews from anywhere, with a notification when an agent finishes.
Agent visibility
Running agents at scale only works when you can see what they’re doing. Home gives you several ways to follow agents across all your workspaces. Switch between a list view and a kanban board, filter to see which workspaces need you, which have agents running, and which are done, and browse your GitHub pull requests and Linear issues to start new work.
Complete development workflow
Integrated git keeps commits, reviews, and merges right next to your files and diffs. And agents don’t wait to be told: they watch for changes and act, so whole workflows run on their own. Open a pull request and an agent monitors it, responds to comments, and pushes updates as things shift.
Built-in browser verification
Agents can open a browser inside the app, click through your web app, and run end-to-end testing autonomously before marking a task as done.
Diagraming
Intent handles diagrams two ways: quick Mermaid blocks that render live everywhere, and native interactive diagrams whose nodes link to your files, symbols, and tests for guided walkthroughs.
Visual verification
For visual work, agents capture before-and-after screenshots and embed them right in the spec’s verification steps, so each claim sits next to the evidence that proves it, another way the spec stays alive as the work progresses.
MCP support
Plug in any MCP server, and agents can use skills and custom tools through it.
Tips
- Think workspace-first, not chat-first. Intent is built around workspaces, not conversations. Treat it as “the place where one task lives,” not “where I talk to an agent.”
- Use one workspace per real task. Each workspace gets its own Git worktree for isolation. If the work is separate, the workspace should be separate.
- Don’t create a new workspace for every agent chat. Multiple specialist agents can collaborate within a single workspace.
- Invest in setup scripts early. Build reliable bootstrapping scripts for fresh worktrees.
- Use the built-in browser as part of the workspace. Keep your running app, test flows, and visual checkpoints attached to the workspace.
- Customize your specialist agents. Shape their prompts to match your actual workflow.
- Mix models across specialists. Assign different providers or models to different roles, such as one for coordination and another for verification.
- Think in orchestration, not single-agent magic. Decide what specialists and context the workspace needs.
Setup
- Go to Settings → Providers to configure your agent provider (Augment Auggie, Anthropic Claude Code, Google Antigravity, Grok Build, OpenAI Codex, OpenCode, Pi, or Unsloth) and default model — the first-run onboarding walks you through this.
- Create a new workspace for each task.
- Point it at an existing repo and choose to work off the main branch in a new worktree, or check Work directly to work in the folder itself.
Getting Started
Intent is a desktop app for AI-assisted software development. You work inside workspaces — each one wraps a git branch with its own AI agents, notes, and file tracking. You describe what you want built, and agents write a spec then implement the code.
Install & Launch
- Download Intent for macOS, Windows (Alpha), or Linux (Alpha)
- Open the app, then click the Home icon at the left end of the tab bar (or press
Cmd+O) to open Home, which lists all your workspaces
Prerequisites
- Intent works with agent providers: Augment Auggie, Anthropic Claude Code, Google Antigravity, Grok Build, OpenAI Codex, OpenCode, Pi, and Unsloth. You’ll need at least one to use Intent.
- Install an agent provider and log in to it with your account.
- Intent will prompt you to install Node.js 22+ (nodejs.org) and Git (git-scm.com) if you don’t already have them.
Create Your First Workspace
Click New workspace in Home or the + at the end of the tab bar, or press Cmd+N anywhere, to start a new workspace. Intent asks “What repo should we work on?” Select an existing codebase or make a new one, and it creates an isolated workspace to work in. Pick one of:
- Pick a repo — Choose one of your GitHub repos (or paste a URL); Intent clones it for you
- Copy local repo — Point at a git repo on your machine; Intent works in an isolated copy, leaving your folder untouched
- New repo — Create a brand-new local git repository from scratch
You can also start from a GitHub pull request or connected Linear issue in Home’s Pull requests and Linear issues tabs. Choose Start workspace to open setup with the relevant details filled in, or return to a workspace already linked to it.
Each workspace gets its own git branch automatically, so your main branch stays untouched. The new-workspace form also lets you:
- Team or single agent — the default is a single Developer agent; switch to a Coordinator-led team (Coordinator + Implementor + Verifier) for larger tasks
- Model — pick a per-provider model, with an optional reasoning-effort level
- Branch — choose the base branch, or check Work directly to skip branch isolation
- Scope — point the workspace at a subdirectory of a monorepo
- Remote machines — run the workspace on a connectedremote machine instead of locally
Have Your First Conversation
Once inside a workspace:
- Type a prompt in the chat input at the bottom — describe what you want
- Watch the agent work — it reads your code, edits files, runs commands, and streams its thinking in real time
- Review the changes — open the Changes panel in the sidebar to see file diffs
- Accept or adjust — if the changes look right, commit them. If not, tell the agent what to fix.
That’s the core loop: prompt → agent works → review → iterate.
What to Try Next
- Write a Spec to give the agent a structured plan (see Context)
- Use a specialist like the Coordinator to break big projects into tasks (see Agents & Chat)
- Open the terminal with
Ctrl+`to run commands alongside the agent
Key Terms
| Term | Meaning |
|---|---|
| Workspace | An isolated project environment: one git branch + agents + notes |
| Agent | An AI assistant that reads and writes code in your workspace |
| Spec | The planning note every workspace has — goals, tasks, acceptance criteria |
| Context | Everything an agent draws on in a workspace — the Spec, your notes, connected MCP servers, and any detected agents and skills files |
| Task Note | A trackable unit of work that agents can be assigned to |
Workspaces
A workspace is your project’s home base in Intent. It bundles a git branch, AI agents, notes, and an activity log into one isolated environment. You can have many workspaces open — one per feature, bug fix, or experiment.
Creating a Workspace
Click New workspace in Home or the + at the end of the tab bar, or press Cmd+N anywhere, then choose:
| Method | What it does |
|---|---|
| Pick a repo | Choose one of your GitHub repos — searchable suggestions from your account, or paste any URL — and Intent clones it for you |
| Copy local repo | Browse to a git repo already on your machine — Intent creates an isolated copy (a git worktree) to work in, leaving your original folder untouched |
| New repo | Pick a folder and a name — Intent initializes a brand-new local git repository there |
Intent creates a dedicated git branch — with an optional, configurable prefix (Settings → Setup → Git & Workspace) — so your main branch is never touched directly.
Switching Between Workspaces
Cmd+O: Toggles Home. Type to search, click to switch.Ctrl+Tab/Ctrl+Shift+Tab: Cycle through recent workspaces.- Use
Cmd+1throughCmd+8to select a workspace tab by position, orCmd+9for the last tab. Alt+Shift+←/→: Reorder workspace tabs.
The Workspace Sidebar
Once inside a workspace, the left sidebar has several tabs:
| Tab | What it shows |
|---|---|
| Agents | All agents in the workspace (Cmd+Shift+D) |
| Context | Everything an agent draws on — the Spec, your notes, connected MCP servers, and any detected agents and skills files (Cmd+Shift+N) |
| Changes | Git status, commits, pull requests, and merging |
| Files | Browse repo files (Cmd+Shift+E), open PDFs in Intent, and download files, including those stored on remote machines |
| Browser | Browser tabs open in the workspace |
| Shell | Workspace terminals |
Toggle the sidebar with Cmd+B.
Managing Workspaces
- Rename: Click the workspace title in the sidebar header to edit it
- Pin: Keep important workspaces sorted first in Home’s workspace list
- Archive: From Home (or by asking an agent), archive workspaces you’re done with, and find them later with the archived filter
- Delete: Permanently remove a workspace and its metadata
Workspace Settings
Each workspace can have its own:
- Git configuration — Remote, base branch
- MCP servers — Extra tool servers for agents
- Setup scripts — Commands that run when the workspace initializes
Agents & Chat
Agents are AI assistants that live inside your workspace. They read your code, edit files, run terminal commands, and use tools — all while streaming their work to you in real time.
Starting an Agent
Cmd+T— Opens a new panel where you start an agent- Choose a specialist; Intent remembers your last manual selection in this workspace. Provider and model choices follow current settings.
- Type your prompt and press Enter to send —
Cmd+Eenhances the prompt first Cmd+Shift+A— Attach files to the message (or drag and drop them into the chat)- Attach and view images and video inline in chat
- Chat messages render mathematical notation, so formulas display properly
- Prefer talking? Voice dictation can be enabled in Settings → Input
You can have multiple agents running simultaneously in the same workspace.
Reviewing Agent Work
- Changes panel — Shows all modified files as diffs
- Click a file — Opens a side-by-side diff view
- Accept — Commit the changes
- Reject — Tell the agent what to fix, or undo
Controlling Agents
| Action | How |
|---|---|
| Stop an agent | Click the stop button in the prompt box |
| Retry | Ask the agent to try again |
| Fork a conversation | Branch the chat from any message |
| Send a follow-up | Messages appear immediately; while the agent is busy, they queue or can interrupt it. Edit pending messages above the composer, or use Send all to send ready messages together. |
| Answer questions | Agents can ask multiple-choice clarifying questions that you answer inline, and you can paste images into your answers |
| Usage limit reached | Intent reports it clearly and offers to retry the same turn on another configured provider |
| Mute notifications | Silence one agent’s notifications from its menu while it keeps working |
| Move to foreground or background | Use the agent’s card menu to switch without interrupting work or losing conversation history |
| Retire an agent | Choose Retire in its card menu or panel’s overflow menu when its work is finished |
Specialists
Not all agents are the same. Specialists are agents pre-configured for specific roles — each with its own behavior, provider, and model. Pick one from the agent picker when you start an agent, or let a Coordinator delegate to them for you.
| Specialist | What it does | When to use |
|---|---|---|
| Coordinator | Plans work, breaks it into tasks, delegates to other agents | Large projects with multiple parts |
| Developer | Plans, implements, and verifies by itself | Solo tasks — build a feature end to end |
| Implementor | Writes code for a specific task | Called by the Coordinator |
| Verifier | Reviews work against acceptance criteria | After implementation, to check quality |
| UI Designer | Creates accessible, polished interfaces | UI-focused work |
| PR Reviewer | Reviews pull requests with actionable feedback | Code review |
Create Your Own Specialists
In Settings → Specialists, create a specialist with a name, behavior prompt, provider, and model. It appears in agent pickers and can be delegated to by a Coordinator. Use specialists to capture your team’s conventions, review standards, or domain expertise.
Intent also discovers existing Claude agent definitions and shows their source alongside your specialists.
Multi-Agent Workflows
Specialists work together on a single task inside one workspace:
- Describe the goal to a Coordinator.
- It writes a plan in the Spec with task blocks.
- You approve the plan.
- It delegates tasks to Implementor agents in parallel.
- A Verifier checks the results before you review and merge.
Context
The Context tab is where you see everything an agent draws on in a workspace: the Spec, any notes you add, the MCP servers you’ve connected, and any agents and skills Markdown files Intent detects in your repository. Together these form the shared context every agent works from. An Attachments grid collects the images, PDFs, and other files attached in the workspace.
Notes are persistent documents inside your workspace. They’re shared between you and your agents — anything you write, agents can read, and vice versa. Add your own notes to give the workspace more context: reference material, requirements, decisions, or links become shared context every agent works from. Notes render images, video, and mathematical notation inline, so you can keep visual context and formulas next to your text. The most important note is the Spec.
The Spec Note
Every workspace has a Spec note. It’s the planning document — the source of truth for what the workspace is trying to accomplish.
A good Spec includes:
- Goal — the user-visible outcome.
- Tasks — work broken down into trackable blocks.
- Acceptance Criteria — how you know it is done.
- Non-goals — what is explicitly out of scope.
Agents read the Spec before starting work. A clear Spec = better agent output.
Visual Verification
Verification steps can carry visual evidence. Agents embed before-and-after screenshots — saved as ordinary workspace files — directly in the Spec with standard Markdown, and Intent renders them inline (in the Spec, task notes, and chat) with a click-to-zoom lightbox, so you can confirm a change at a glance instead of rebuilding it from a diff.
Creating & Editing Notes
- Open the Context tab in the sidebar (
Cmd+Shift+N) - Click + New Note to create one
- Notes use a Markdown editor with rich formatting
- Add tags to organize notes
- All changes save automatically
Use the command palette (Cmd+K) to search note contents across workspaces. Results show a preview and workspace name; select one to open the note there.
Task Blocks
Agents create trackable tasks automatically as they plan — if one doesn’t, just ask it to. Under the hood, tasks are @@@task blocks, which you can also write yourself in any note:
@@@task
# Add user authentication
## Scope
- Login/logout endpoints
- JWT token management
@@@When you save the note:
- Each
@@@taskblock converts into a Task Note - The block is replaced with a linked checkbox
- Agents can be assigned to Task Notes and update their status
Rules:
- One task per
@@@taskblock - The first
# Headingbecomes the task title - Everything below is the task body
- Optional attributes on the fence line —
key=,dependsOn=,conflictsWith=,effort=— express dependencies and estimates
Task Notes track richer statuses than just to-do and done — in progress, blocked, waiting, review required — and can be delegated to agents directly from the note.
Rich Blocks
Notes support special blocks that make documentation actionable:
| Block | What it does |
|---|---|
| Code reference | Links to a file or symbol and stays current as code changes |
| CLI block | A runnable shell command |
| Diagram | A Mermaid sketch, or a native interactive diagram whose nodes link to files, symbols, and tests. In Preview, view a diagram’s source, open it fullscreen, or export it as an SVG. |
| Agent action | A button that triggers an agent |
Comments
- Highlight text and click Comment
- Agents can comment too — useful for questions or suggestions
- Comments appear as threads anchored to specific text
- Resolve threads when addressed
Comments are great for async collaboration between you and your agents.
MCP Servers
Any MCP servers you’ve connected appear in the Context tab, so you can see which external tools and data sources are available to agents in this workspace. Agents call these tools directly as part of their work. Connect and manage servers in Settings & Configuration.
Agents & Skills Files
Intent automatically scans your repository for agents and skills Markdown files — such as AGENTS.md, CLAUDE.md, and files under a skills/ directory — and, when present, surfaces them in the Context tab. These files are picked up as shared context so agents follow your project’s conventions and use the skills you’ve defined without any extra setup.
Git & Code Changes
The easiest way to handle git is to just talk to your agents and turn on auto-commit — agents commit their own work with descriptive messages as they go, so you rarely have to think about it. If you have a specific workflow or want a more visual way to move through the git process, we’ve built it into the Changes panel. From there you can:
Viewing Changes
Open the Changes tab in the sidebar. It’s a timeline of the branch: file changes at the top, then commits, the pull request, and merging. The file list shows:
- Modified files — Files the agent (or you) changed
- Staged files — Files ready to commit
- Untracked files — New files not yet tracked by git
Committing
Two ways to commit:
- Agent auto-commit — Agents commit their own work with descriptive messages as they go
- Manual commit — Open the Commit drawer, stage files, write a message (or auto-generate one with the message button), and commit
From the commits timeline you can also push commits to the remote and undo or amend recent local commits.
Pull Requests
- Create a PR — Intent pre-fills (or auto-generates) the title, description, and target branch
- View PR status — A pull request dropdown on the Changes launcher shows CI checks, review comments, and merge state; merge-queued PRs show a PR Queued status
- Address review comments — Agents can read and respond to PR feedback, and can monitor a PR in the background to act on comments and CI results
- Merge — Merge directly from Intent when the PR is ready
Merging Locally
The Merge drawer merges the workspace branch back to trunk without a PR, and post-merge actions offer cleanup — like resetting the workspace to trunk.
Commit History
The Changes tab timeline shows commits — local and pushed — alongside the branch’s PR and merge state. Click a commit to open its diff.
Home
Home gives you several views into your agents across all your workspaces, so you can see what’s happening in every project, respond to agents, and pick up your next task without opening each workspace. Click the Home icon at the left end of the tab bar (or press Cmd+O) to open it.
Home’s sidebar switches between Workspaces and Assistant. In Workspaces, it lists your repositories by organization with a workspace count for each. Choose All repos, an organization, or a single repository to narrow the view. The main area has three tabs: Workspaces, Pull requests, and Linear issues.
Workspaces
The Workspaces tab shows your workspaces grouped into Needs you, Running, and Done & idle. Switch between a list view, with one row per workspace, and a board view, with a column of cards for each group. Search for a workspace, or filter by All, Needs you, Running, or Archived. Open View options to show only workspaces updated within a time range, to group workspaces by repository instead, or to group them by detailed status, such as In progress, PR open, PR mergeable, PR queued, and PR merged. Each workspace shows:
- Workspace name and repository
- Its latest pull request and whether it’s open or merged
- The workspace status message
- Whether it’s waiting on you or has agents running, and when it was last active
Select a workspace to open its chat beside the list, where you can read progress, switch between its agents, and send follow-up messages. Click the preview title to open the full workspace, or Cmd/Ctrl-click a workspace to open it directly. Pin workspaces to keep them at the top. For a mission-control view of every workspace and its agents, open the Fleet HUD with Cmd+Shift+H.
Pull Requests & Linear Issues
The Pull requests tab lists GitHub pull requests you created, were assigned, or were asked to review, and the Linear issues tab lists issues from a connected Linear account. Preview either one, or choose Start workspace to begin work on it.
Assistant
Assistant in the sidebar opens an app-level assistant that works across the whole app rather than inside one workspace. Ask it to manage workspaces (create new ones, archive or clean up stale ones), tune settings, coordinate specialists, prepare a daily brief, or spin up workspaces for the PRs assigned to you. Open notes, files, websites, workspaces, and agent conversations alongside the chat, and each thread remembers its panel layout. Conversations are kept as threads you can return to, rename by clicking the title in the chat header, or delete. You can also ask the Assistant to add and check MCP servers, or to rename, delete, or restore your other chats.
Panels & Layout
Each panel holds a stack of content, with one item visible at a time. Use the header dropdown to switch between items in that stack.
The Main Areas
| Area | What lives here |
|---|---|
| Sidebar | Launcher tabs — Agents, Context, Changes, Files, Browser, Shell |
| Panel canvas | Panels containing stacks of agent chats, notes, files, diffs, and browser pages |
| Terminal overlay | Workspace terminals, sliding down from the top |
Arranging Panels
To give an item its own panel, select it from the stack dropdown, then use the directional controls in the three-dot overflow menu to move it left, right, above, or below. Drag an edge to resize; layout changes preserve panel sizes and support undo and redo.
Panel & Stack Shortcuts
| Action | Shortcut |
|---|---|
| Close current stack item | Cmd+W |
| Reopen last closed item or panel | Cmd+Shift+T |
| New column to the right | Cmd+\ |
| Next / previous item in stack | Cmd+] / Cmd+[ |
| Next / previous column | Cmd+Shift+] / Cmd+Shift+[ |
| Move current stack item left / right | Cmd+Alt+PgUp / Cmd+Alt+PgDn |
| Maximize panel | Cmd+Shift+M |
| Resize panel | Cmd+Alt+←/→ |
Terminal
Intent has a built-in terminal so you can run commands without switching apps. It slides down from the top like a quake-style console.
Opening the Terminal
Ctrl+`— Toggle the terminal overlayCmd+J— Alternate toggle shortcut
Multiple Tabs
Create new terminals with the + button in the terminal overlay.
| Action | Shortcut |
|---|---|
| Next tab | Cmd+Shift+] |
| Previous tab | Cmd+Shift+[ |
| Close tab | Cmd+W |
Scripts
The terminal overlay includes a Scripts sidebar — saved per-workspace build, test, and service commands. Run-once commands execute to completion, while long-running services keep output viewers you can check anytime. Fresh worktrees also get a setup-script banner to bootstrap the checkout.
Agents & Terminals
Agents can run terminal commands as part of their work — installing dependencies, running tests, starting dev servers. You’ll see their terminal output in real time, and URLs printed in the terminal are clickable and open in the browser panel.
Agents can monitor commands and resume on completion, a deadline, or matching output. Use the chat footer to inspect or copy the command, view output, stop monitoring, or cancel the command.
Browsers
Intent includes a built-in web browser for previewing web applications without leaving the app.
Opening the Browser
- An agent starts a dev server and navigates to it
- You open a URL from agent output or a note
- You manually navigate to a URL in the browser panel
The Browser sidebar tab lists every tab open in the workspace. Tabs opened by agents start hidden — reveal them from the sidebar, or the agent shows them itself. Open tabs stay with the workspace and are restored when you reopen it. When a workspace runs on a remote machine, you can watch and take over the same browser session from another device.
Open or close an agent’s browser tabs from its panel’s three-dot overflow menu. Tabs stay alive and owned by that agent while the workspace is out of view.
Dev Server Preview
When an agent runs a dev server, it can automatically open the browser panel to the local URL. As the agent makes changes, you see updates in real time.
Navigation
Back and forward live in the browser toolbar. An element picker in the toolbar lets you point at any element on the page.
| Action | Shortcut |
|---|---|
| Refresh | F5 / Cmd+R |
| Copy current URL | Cmd+Shift+C |
Agent Browser Interaction
Agents can take screenshots, inspect the page for layout, accessibility, and console errors, and interact with elements to test functionality. During structured capture runs, Intent records a screenshot, the page’s accessibility tree, and console output at each step, giving agents an archive of visual states to embed as verification evidence. Tabs are tracked per agent — an agent drives its own tabs, and you can always view and take over.
Multi-device support
Run workspaces on remote machines and move them between local and remote devices. Offload tasks like long test runs to a remote machine, then pick the workspace back up locally when they’re done.
Connecting a Device
- On the machine you want to connect to, open Settings → Mobile, turn on Remote Access, and copy its connection details.
- On your current machine, open Settings → Machines and add the remote machine using its name, host, port, and access token.
- Click Continue, check that the certificate fingerprint matches the remote machine, then choose Confirm & connect.
Manage saved connections in Settings → Machines, where you can test a connection or reconnect. Settings → Mobile holds remote access and phone pairing controls. Supported remote machines can update their backend to match the desktop app. On supported Apple devices, you can save connections to iCloud Keychain to make them available on your other devices.
Moving a Workspace
- Open the workspace’s menu and choose Transfer/Download….
- Select a destination device and click Next. When you’re connected to a remote machine, your local machine is also available as a destination.
- Review the transfer summary, estimated size, and any warnings, then clickStart transfer.
- If you want active agents to continue there, select Restart in-flight agents on the destination during the transfer. Once it finishes, open the workspace on the destination. You can also choose to archive the source workspace.
Transfers include notes, agent conversations, workspace assets, and the Git repository. Uncommitted changes are captured in a work-in-progress snapshot. Active agents stop before the transfer begins. Event history, terminal sessions, and server settings stay on the source machine, so configure the providers and tools you need on the destination.
You can also ask the Assistant to move a workspace, then review and approve its transfer card in chat. Successful moves through the Assistant archive the source workspace.
Running Work Remotely
To offload a long test run, transfer the workspace to your remote machine, open it there, and ask an agent to run the tests. You can review its progress from your local device while the work runs remotely. When the tests finish, useTransfer/Download… again and choose your local machine to continue working there. Wait for terminal commands to finish before transferring, since running processes do not move with the workspace.
Intent mobile
Intent Mobile is a remote control for Intent across all your devices. From an iPhone, iPad, or iPhone Duo, you can monitor and steer agents, create new workspaces, and review changes wherever you are. All work runs on your computer, so the app needs a paired machine to connect to.
Download Intent mobile on the App Store
Connecting to Your Computer
- Pairing: Scan the QR code shown in the desktop app, tap an
intent://pairlink, or enter the host, port, and token yourself. - Security: The app checks your computer’s certificate and refuses to connect if it doesn’t match. Login details are stored in the iOS Keychain.
- Remote access: When you’re away from home, the app can connect through a Tailcat tunnel. It tries the direct address and the tunnel at the same time and uses whichever connects first.
- Several computers: Save more than one machine, switch between them, and see each connection’s status. Disconnecting a machine means you’ll need to pair it again later.
You can also pair the app with remote machines that run only the background service.
Workspaces
The home screen links to the Assistant, a new workspace, your connections, appearance, and settings, along with your recent agents. The workspace list shows status icons, PR badges, items that need your attention, and status screenshots. Swipe a row to rename, archive, delete, or mute it, or select several workspaces to act on them at once.
On iPad, a navigation bar keeps Workspaces, Assistant, Connections, appearance, and Settings in reach, and the workspace list sits beside your conversation. On iPhone Duo, the list and the selected workspace appear on the two halves of the display when unfolded.
Creating a workspace walks you through picking a repo (or starting a new one), a branch, a specialist, a provider and model, and an opening prompt. You can also move a workspace to another paired computer and optionally archive the original. Moving requires owner access on both machines.
Inside a workspace, three tabs match the desktop sidebar:
- Agents: Agent chats, grouped, with their history
- Context: Notes and tasks
- Changes: Code changes and commits
Chatting with Agents
- Send messages with images and files attached, or use voice dictation
- Switch the model and reasoning level, or stop a reply partway through
- Edit, remove, or immediately send messages waiting in the queue while an agent is busy
- Answer agent questions, and accept or dismiss proposals such as a suggested follow-up workspace
Messages render Markdown, code blocks with a copy button, tool calls, and Mermaid diagrams, which draw without an internet connection. Images and video open full screen, where you can save or copy them. PDFs open in a full-screen viewer you can scroll, zoom, and share. Text, Markdown, JSON, logs, and source files open in a text viewer, and HTML files display as formatted pages. A status strip shows background hooks and watched PRs, which you can run, refresh, or cancel, and explains why an agent woke up. The Assistant is also available as a general chat with its own conversation history.
Notes, Tasks, and Code Changes
Read notes in Markdown, including sub-notes and attachments. Change the status of a task note or a single checkbox line and track task progress. The Changes tab shows staged and unstaged changes as a file tree with line-by-line diffs, and lets you browse commit history and open any commit’s diff.
Developer Tools
- Terminals: Create, use, resize, and delete terminals. A key bar above the keyboard adds Control and the arrow keys.
- Scripts: View a workspace’s saved scripts, start or stop them, and delete them.
- Browser previews: Open dev servers running on your computer. Previews use a separate signed-in tunnel, so your connection credentials never reach the web page.
Offline Access and Notifications
Workspaces, notes, and conversations are saved on your device, so you can read them without a connection. When an agent finishes, you get a notification naming the agent and workspace, and tapping it opens that conversation. In Settings, you can pair a new computer, export diagnostic logs as a ZIP file, view acknowledgements, and disconnect.
Settings & Configuration
Open Settings with Cmd+,. Settings are organized into these tabs:
| Tab | Contains |
|---|---|
| Display | Theme, color theme, fonts for notes, chat, and code, language |
| App Behavior | Updates, external editors, GitHub link handling, notifications |
| Agent Behavior | Global instructions, agent features, default models for quick actions |
| Providers | Agent providers (Augment Auggie, Anthropic Claude Code, Google Antigravity, Grok Build, OpenAI Codex, OpenCode, Pi, Unsloth), default model |
| Connections | GitHub, Linear, Sentry, MCP servers |
| Machines | Connect to remote machines and manage saved connections |
| Mobile | Remote access and phone pairing |
| Setup | Git & workspace (branch prefix, worktrees location), shell, CLI optimization |
| Input | Editable keyboard shortcuts, voice dictation |
| Advanced | Agent backend, data and reset |
| Specialists | Edit built-in specialist prompts, create custom specialists |
AI Providers
In Providers, configure which agent providers agents use and set the default model for new agents. Supported providers are Augment Auggie, Anthropic Claude Code, Google Antigravity, Grok Build, OpenAI Codex, OpenCode, Pi, and Unsloth. Different specialists may use different models.
MCP Servers
MCP servers give agents access to external tools — databases, APIs, design tools, and more.
- Add servers globally or per workspace
- Each server provides a set of tools agents can call
- Configure in Settings → Connections
Theme, Fonts & Display
- Light / Dark / System theme — follows your OS preference by default
- Chat font style — Choose how agent messages look
- Code font — Pick the monospace font for code blocks and the editor
- Note font — Serif or sans-serif for note content
- All under Settings → Display
Connections
| Service | What it enables |
|---|---|
| GitHub | Clone repos, create PRs, review comments, and merge |
| Linear | Browse Linear issues in Home and start workspaces from them |
| Sentry | Connect error tracking |
Voice Dictation
Dictate prompts instead of typing — configure local Whisper or ElevenLabs transcription under Settings → Input.
Rules & Skills
Customize how agents behave:
- AGENTS.md — A file in your project root that agents read automatically
- Global instructions — Personal rules applied across all workspaces (Settings → Agent Behavior)
- Skills — Specialized instruction sets agents load for specific tasks
Rules are the best way to get consistently good output from agents — tell them your project’s patterns once, and every agent follows them.
Token Savings
Agent coordination provides better results but uses more tokens, because agents have to communicate. For a small task, a single agent costs less than a Coordinator-led team, which is why new workspaces start with one by default. When cost matters, Intent offers several ways to reduce token use.
Compact tool output (on by default)
Agents get one workspace_api tool and write small scripts against it instead of loading dozens of separate MCP tools. Only what a script returns enters the agent’s context, and a single call can batch many reads and writes, so work that would take ten tool calls takes one.
- TOON output — Tool results are encoded in a compact, token-efficient format instead of pretty-printed JSON.
- Large output to a file — Oversized results are written to disk (default 100k characters) rather than dumped into the conversation.
- Slim conversation reads — When one agent reads another’s transcript, large tool inputs, outputs, and images are truncated to previews, and the full body is fetched only on demand.
Turn off features you don’t use
In Settings → Agent features, each toggle removes that feature’s instructions and tool docs from every new agent session. The panel shows the approximate saving per toggle:
| Feature | Approx. saving |
|---|---|
| Background hooks | ~620 tokens/session |
| Attention requests | ~340 tokens/session |
| Rich chat blocks | ~310 tokens/session |
| PR monitor | ~290 tokens/session |
| Saved scripts | ~240 tokens/session |
| Structured questions | ~180 tokens/session |
| Task graph teaching | ~170 tokens/session, plus each completion wake |
| External MCP tools | ~170 tokens/session |
| Top-level agent spawning (off by default) | ~80 tokens/session |
| State snapshot | ~50 tokens/turn |
| Host exec, Terminal access, Browser automation | ~50 tokens/session each |
RTK compressed CLI output
In Settings → Tools → RTK (off by default), enable RTK and install the rtk binary to have agents run supported shell commands through it. RTK compresses verbose CLI output such as test runs, git logs, and build output before it reaches the model.
Cheaper models and lower reasoning effort
- Agent backend — Choose which provider or CLI backs your agents in Advanced settings.
- Per-agent model and effort — Delegate sub-agents with a specific model, provider, and reasoning effort, so implementors and verifiers can run a cheaper, lower-effort model while the Coordinator uses a stronger one. Specialists carry model hints for this.
See where tokens go
Click the token count beside Agents in the workspace sidebar for input, output, cached, and reasoning tokens. Filter by agent and model, separately or together, to explore usage. Costs appear when the provider reports them.
Fewer, cheaper agent wakes
Every turn re-sends the whole context, so fewer turns means fewer tokens.
- Hooks and PR monitors — The daemon does the checking and wakes an agent only on a meaningful change, instead of polling inside a turn.
- Debounced PR wakes — A stream of comments and checks collapses into one wake.
- Batched reports and events — Report-to-parent debounce and batched event subscriptions combine several child reports or events into a single wake.
- Flushed message queue — Waiting messages are delivered together at the end of a turn.
- Idle reaping and agent caps — Forgotten or runaway agents are stopped before they burn more turns.
Notes as shared memory
Specs, task notes, and notes persist across agents and sessions, so an agent reads a short note instead of re-deriving context or re-reading a long transcript. Listing tasks returns their IDs without loading the whole note.
Keyboard Shortcuts
Press Cmd+? (Cmd+Shift+/) to open the full shortcuts reference, searchable, grouped by category, and editable:
- Global
- Workspace Navigation
- Panels & Stacks
- Chat & Agents
- Terminal
- Browser
- Leader Key (Cmd+;)
Rebind any shortcut by capturing a new key combination, and reset a single override or all of them back to the defaults.
Support
Ask the Assistant
Start with the Assistant, which you can open from the sidebar on the app’s Home screen. It can answer most help questions and troubleshoot issues. It uses a built-in guide to Intent that updates with the app, and checks your actual settings and agent status when your situation matters. Answers include steps and links that open the right place in the app, like a specific Settings page.
File an issue
If you still need help or have a feature request, file an issue on GitHub. We’ll take a look, and fix bugs we can verify.
Open Source
Intent is licensed under the Apache License 2.0.