Workspace
The workspace is where you prompt agents, review their changes, and run your app, all in the browser. It opens when you open a machine. This page is a reference for each part of it: the title bar, the sidebar, the center area, the right panel, and the terminal dock.
Layout
Section titled “Layout”| Region | Contents |
|---|---|
| Title bar | Back and forward, the current location, people on the machine, and session actions. |
| Sidebar | The machine menu, search, the home page, and sessions grouped by repository. |
| Center | Tabs for chats, open files, diffs, and previews. |
| Right panel | Tabs for files, changes, checks, and review comments. |
| Terminal dock | Setup and run output, terminals, and listening ports. |
Below 960 pixels wide, the workspace uses a single-column layout for mobile devices.
Title bar
Section titled “Title bar”The location reads machine, repository, session. Select the machine name to go to the home page.
Select the session title to open the session menu:
| Item | Action |
|---|---|
| Rename | Renames the session. |
| Copy branch name | Copies the session’s branch name. |
| Copy worktree path | Copies the path of the session’s worktree. |
| Copy link for guests | Copies a link to the session for people on the machine. |
| Fork session | Creates a session branched from this session’s branch. |
| Deploy preview | Refer to Preview a session. |
| Archive | Removes the worktree. Keeps the branch, unless Delete branch on archive is on. |
| Delete | Removes the session, with or without its branch. |
The right side of the title bar has the avatars of other people on the machine, the editor button, the pull request button, Share, and the right panel toggle. Guests see People instead of Share. Select an avatar to follow that person.
Sidebar
Section titled “Sidebar”- Machine menu: Switches machines, shows CPU, memory, and disk use, starts or stops the machine, and opens Machine settings, Fork machine, and New machine.
- Search: Finds sessions, files, and commands.
- Home: Opens the prompt for new sessions, your recent sessions, and your machines.
- New session: Starts a session in the current repository.
- Repositories: Lists each repository with its sessions. Select + to start a session in it. Open the … menu to start a session, change the icon, or remove the repository.
- Add repository: Clones a repository, creates a new one, or opens a folder. Host only.
- Archived: Lists archived sessions.
A session row shows the agent’s state, the title, the branch, and the diffstat against the base branch. Open the … menu on a row to rename the session, copy its branch name, open its pull request, archive it, or delete it.
A repository icon is stored in the repository’s git config as orchard.icon. Everyone on the machine sees the same icon.
Settings
Section titled “Settings”Select the gear icon in the sidebar, or press CMD + ,.
| Group | Section | Contents |
|---|---|---|
| Machine | Machine | Name, SSH key, people, setup script, attached projects, and machine deletion. |
| Machine | Usage | CPU, memory, disk, and time limits. |
| You | Preferences | Send messages with, Follow-up behavior, Auto-accept permissions, Agent notifications, and transcript options such as Show reasoning. |
| You | Sounds | The sound for each agent event. |
| You | Appearance | Theme, zoom, text sizes, and fonts. |
| You | Git | Branch name prefix and Delete branch on archive. |
| You | Agents | The coding agents on this machine, their sign-in state, and Claude usage limits. Requires a running machine. |
| You | Context | Your CLAUDE.md, subagents, slash commands, skills, and MCP servers. To import them from Claude Code, run orchard claude import. |
| You | Integrations | Your GitHub, Linear, and Slack accounts. |
| You | Shortcuts | Every keyboard shortcut and command. |
Greenhouse saves Preferences, Appearance, and Git on the current device.
Remove flattery removes flattery from agent replies in your view. The stored transcript does not change.
Each chat is one thread that everyone in the session can see.
- Plain text is a prompt to the agent. The thread shows who sent it.
/chat <message>is a comment to the people in the session. The agent does not see it.
Select + in the tab strip to start another chat in the same worktree. Checkpoints lists the prompts of the current chat. Select a prompt to undo everything the agent did after it.
The thread collapses the steps of a turn into one activity row. Expand the row to see each step.
Permission and question cards
Section titled “Permission and question cards”When the agent needs a decision, it waits and a card appears above the composer.
| Card | Actions |
|---|---|
| Permission | Allow approves this request. Always allow stops asking for this kind of request. Deny refuses it. You can tell the agent what to do instead. |
| Question | Select an option, or enter your own answer. Skip dismisses the question. |
| Plan | Start building leaves plan mode. Keep planning stays in plan mode. You can also send feedback. |
Read-only guests see the cards but cannot answer them.
Auto-accept permissions allows permission requests automatically in chats where you sent the last prompt. Questions still wait for an answer.
Composer
Section titled “Composer”- Attach files or images adds up to 10 files of up to 5 MB each. You can also drop files on the composer.
- The model menu selects the model, the effort, and the agent for the next prompt.
- Plan mode runs the agent read-only, so that it proposes a plan without editing files.
- The ring shows how much of the model’s context the chat has used.
If you send a prompt while the agent is working, the prompt waits in a queue by default. Queued prompts go out one at a time. To interrupt the agent instead, change Follow-up behavior to steer.
Slash commands
Section titled “Slash commands”Type / in the composer to list commands. Built-in commands act on Greenhouse. /init, /review, and /security-review send the agent a prepared prompt.
| Command | Action |
|---|---|
/help |
Lists every command. |
/clear, /new |
Starts a new chat in a new tab. |
/compact |
Summarizes the chat to free up context. |
/resume, /continue |
Switches to another chat. |
/rename <title> |
Renames the session. |
/export |
Downloads the chat as Markdown. |
/undo, /rewind |
Rolls back the last prompt and its changes. |
/redo |
Restores what /undo rolled back. |
/todos |
Shows the agent’s todo list. |
/stop |
Stops the agent. |
/chat <message> |
Messages the people in the session. |
/model |
Selects the model. |
/effort |
Sets the reasoning effort. |
/fast |
Turns fast mode on or off. |
/plan, /build |
Enters or leaves plan mode. |
/agents |
Selects the agent that answers. |
/init |
Writes an AGENTS.md for the repository. |
/review |
Reviews uncommitted changes, or a commit, branch, or pull request. |
/security-review |
Reviews the branch for security issues. |
/context, /cost, /usage |
Shows context used, cost, and Claude usage limits. |
/mcp |
Manages MCP servers. |
/memory |
Edits AGENTS.md or CLAUDE.md. |
/permissions |
Opens permission settings. |
/terminal |
Opens a terminal. |
/diff |
Opens Changes. |
/pr |
Creates or opens the pull request. |
/status |
Shows machine and branch status. |
/share |
Opens the share sheet. |
/settings, /config |
Opens settings. |
/bug, /feedback |
Opens a new issue on the Orchard repository. |
Commands that the agent server reports for the repository, such as skills and MCP prompts, appear under Repository.
Editor
Section titled “Editor”Files open in the Monaco editor. Files up to 500 KB can be edited in the browser. To edit a larger file, connect an editor over SSH.
When two people open the same file, they edit it together and see each other’s cursors. Edits that the agent makes on disk merge into the open file.
Diffs and review comments
Section titled “Diffs and review comments”Select a changed file to open its diff. Select a line number to comment on that line. Comments appear in the Review tab of the right panel, grouped by file.
Send review to agent combines all comments into one prompt and queues it.
Right panel
Section titled “Right panel”| Tab | Contents |
|---|---|
| All files | The worktree as a tree. Right-click to create, rename, or delete files and folders. |
| Changes | Changed files with line counts, and a commit box. Refer to Commit, push, and merge. |
| Checks | The pull request’s state, its checks, and Fix with agent. Refer to Checks. |
| Review | Your diff comments. |
Terminal dock
Section titled “Terminal dock”| Tab | Contents |
|---|---|
| Setup | Output of the session’s setup script. Read-only. |
| Run | Output of the run script, with start and stop controls. A repository with several commands has one tab per command. Refer to Configure setup and run scripts. |
| Terminal | A shell in the session’s worktree. Select + to open another. |
| Ports | Ports that processes on the machine listen on. Refer to Preview a session. |
Terminals run inside tmux on the machine. They survive a page reload or a dropped connection.
Each person has their own terminals, with their own git identity and GitHub credential. You can watch another person’s terminal, but you can type only in your own. Setup and Run are the same for everyone in the session.
Keyboard shortcuts
Section titled “Keyboard shortcuts”On Windows and Linux, use CTRL for CMD, and ALT for OPT.
| Shortcut | Action |
|---|---|
CMD + N |
New session in the current repository |
CMD + K |
Search sessions, files, and commands |
CMD + B |
Show or hide the sidebar |
CMD + OPT + B |
Show or hide the right panel |
CMD + SHIFT + G |
Open the Changes tab |
CMD + , |
Open settings |
ENTER |
Send the prompt |
SHIFT + ENTER |
New line in the prompt |
CMD + ENTER |
Steer instead of queueing |
ESC |
Stop the agent while it is working |
/, TAB |
Complete a command |
CTRL + O |
Expand or collapse tool calls |
CMD + SHIFT + E |
Fast mode, when the model has one |
CMD + SHIFT + / |
Cycle reasoning effort |
CMD + P |
Find a file |
CMD + S |
Save the open file |
CMD + F |
Find in the file |
CMD + ` |
Focus the terminal |
CMD + J |
Collapse or expand the dock |
CMD + +, CMD + −, CMD + 0 |
Change or reset the code size in a terminal |
On a focused permission or question card:
| Shortcut | Action |
|---|---|
ENTER |
Allow, or submit the answer |
CMD + ENTER |
Always allow |
ESC |
Deny, then press ENTER to send |
1 to 9 |
Select an option |
In the Changes tab and in diff comments, CMD + ENTER commits or posts.
The Send messages with preference changes the send and new-line keys. Settings > Shortcuts shows the current keys.
Related resources
Section titled “Related resources”- Share a machine - Invite people into the workspace and review what each role can do.
- Keyboard shortcuts and search - Use the shortcuts and search of the Orchard dashboard.