How to use The Agent Office
Where each feature lives in the app, and how to use it: a short video and a few steps each.
ask for anything
Starts a worker on a task you describe in a sentence, without a ticket.
Where to find it: Hire, at the top of the list.
- Click Hire in the bar at the top of the office.
- In “Ask for anything”, type what you want done, in plain words.
- Pick a repo, or “No repo” to have it research without changing anything.
- Click Hire a worker. A worker takes a desk and its chat opens.
Tip: Click Discuss instead to talk the plan through before any code changes.
connect tickets
Lists your tickets from Jira, Linear, GitHub Issues or 8090 in Hire, so you can assign one to a worker.
Where to find it: Settings → Workspace → Tickets from.
- Open Settings and go to Workspace.
- Under “Tickets from”, pick Jira, Linear, GitHub Issues or 8090 and click Connect.
- Approve The Agent Office in the browser tab that opens.
- Tick the projects to follow and the repo each one works in, then click Save.
- Open Hire and click Hire a worker on any ticket.
Tip: Filter in Hire shows one tracker, or only the tickets assigned to you.
permissions
Sets which actions a worker can take without asking you first.
Where to find it: Settings → General → New workers, and the sliders beside a worker’s name.
- Pick a level for new workers in Settings → General → New workers: Ask first, Standard or Full auto.
- To let everyone run without asking for a while, turn on “Override: everyone on full auto”.
- To change one worker, click the sliders beside its name and pick its Permission.
- When a worker asks, an approval card shows in its chat. Click Approve or Deny.
Tip: On Standard, a worker edits its own folder freely and asks before installs, pushes, network calls and deletes.
memory
Shows the lessons workers have saved for each repo. New workers in that repo are given the ones that apply.
Where to find it: Settings → Memory, and the book beside a worker’s name.
- Open Settings → Memory and pick a repo to see its lessons.
- Click Add, write the lesson, pick its kind and click Add lesson.
- To correct a lesson, click its pencil, change it and click Save.
- Click Export to download the repo’s lessons as a Markdown file.
Tip: The book beside a worker’s name shows when it is reading or saving a lesson. Click it to see that worker’s memories.
toolkit
Manages the agents, skills and MCP servers workers can use, for all repos or for one.
Where to find it: Settings → Toolkit.
- Open Settings → Toolkit and pick Agents, Skills or MCPs.
- Pick where it applies: General for every repo, or one repo’s name.
- Click New agent or New skill to write your own.
- For a repo, click Sync after a change, so its agents, skills and MCPs are brought up to date.
preview & network
Runs a worker’s app inside the Mac app, so you can pick page elements and network calls to send to that worker.
Where to find it: A worker’s chat → Preview (in the Mac app).
- Open a worker and click Preview, then Start to run its app.
- Click Select element, click a part of the page and write what should change. Click Pin.
- Open Network to see the calls the page makes, and click any call to add it to the chat.
- Click Send picked to hand the worker your pins and calls.
Tip: Open in its own window gives the preview a whole screen.
slack
Connects a Slack workspace. You can send threads to Pam, and workers can post in channels once you approve.
Where to find it: Settings → Connectors → Slack.
- Open Settings → Connectors and click Add to Slack.
- In Slack, send any thread to your office from ⋯ → Send to my office. Pam summarizes it, saves it as an idea or starts a ticket.
- Mention @TheAgentOffice to ask Pam anything about the office.
- In a worker’s chat, type # and pick a channel to have it post there. You approve every post.
remote control
Lets you see workers, answer their requests and hire from your phone’s browser.
Where to find it: Settings → Connectors → Remote control, and theagentoffice.app/remote on your phone.
- On your Mac, open Settings → Connectors and turn Remote control On.
- On your phone, open theagentoffice.app/remote and sign in with the same account.
- Your Mac asks to allow the phone. Check that the codes match and click Allow.
- When a worker needs you, open it on your phone and tap Approve or Deny.
Tip: Everything between your Mac and your phone is end-to-end encrypted.
spaces
Splits the office into separate rooms. Each space has its own desks and skin.
Where to find it: The space pill in the bar at the top of the office.
- Click the space pill at the top of the office.
- Click Add a space, name it and press Enter.
- Click the pencil beside a space and choose a skin for it.
- Drag a worker onto the pill and drop it on another space to move it there.
Tip: Cmd ← and Cmd → step between spaces.
worker instructions
Text every new worker gets: your house rules, and what it should do first.
Where to find it: Settings → Instructions.
- Open Settings → Instructions.
- Write your House rules: what every worker should always do, or never do.
- Change the first step for a normal hire, or for a Discuss hire, if you want them to start differently.
- Click Save. The next worker you hire gets them.
Tip: Reset to default brings back the office’s own wording.
automatic qa & auto-development
Per repo: Automatic QA runs the tests on new commits and files bugs; Auto-development opens a PR for each issue with the Ready label.
Where to find it: Settings → Repos → Automatic QA and Auto-development.
- Open Settings → Repos and find the repo under “Automatic QA and Auto-development”.
- Turn on Automatic QA. It runs the repo’s tests on each new commit and files the bugs it confirms.
- Turn on Auto-development. It takes issues carrying the Ready label and opens a PR for each.
- Leave Auto-merge PRs off to review each PR yourself. Nothing is merged unless it is on.
Tip: The Ready label is “ready for development” unless you change it.
open the office
Also for Linux (x64): AppImage · .deb · All downloads
Also as a .deb for Ubuntu and Debian, or for Mac · All downloads
For Windows 11, through WSL · All downloads
The Agent Office needs a Mac with Apple Silicon (M1 or later). All downloads
Get it on your Mac or Linux computer. https://www.theagentoffice.app/download · Remote control for your phone · All downloads
For Apple Silicon Macs and 64-bit Linux, with a coding agent installed. On Windows? Install with WSL