Shepherd Docs · Product tour

Learn the workspace
one step at a time.

Six short walkthroughs show how to keep an agent running, follow its progress, review its changes, pick up an earlier conversation, and automate routine work.

01 / 06

Persistent sessions

Close Shepherd and return to the same running work.

Try it in Shepherd

  1. Start a task in a Shepherd terminal.
  2. Quit the desktop app while the task runs on your Mac.
  3. Open Shepherd again to reconnect to its tabs, panes, and terminal session.
02 / 06

Agent Monitor

Find the coding agent that needs your attention.

Try it in Shepherd

  1. Run coding agents in your Shepherd workspaces.
  2. Check Agent Monitor for agents that are working, waiting, or finished.
  3. Select an agent to open its session, or use the floating Live Agent Monitor while another app is in front.
03 / 06

Files and diffs

Read files and review changes beside your terminal.

Try it in Shepherd

  1. Open a workspace file to preview Markdown or inspect code.
  2. After the agent edits files, open the Diffs panel.
  3. Select a changed file to inspect its exact diff.
04 / 06

Browser Review

Point to a page element and send your feedback to the agent.

Try it in Shepherd

  1. Ask your agent to open the running page in a connected Shepherd browser review.
  2. Choose Comment, select the element, and write what should change.
  3. Send the collected review to the agent, then check the updated page.
05 / 06

Agent History

Continue a previous coding-agent conversation.

Try it in Shepherd

  1. Open Agent History from the right panel.
  2. Find the conversation in its project and choose Resume.
  3. Continue it in a new terminal with the provider conversation context.
06 / 06

Workflows

Let routine work run on its own.

Try it in Shepherd

  1. Open Workflows from the left sidebar and describe a task, or write YAML.
  2. Chain Agent, Shell, and Data steps, then set a schedule that runs on your server.
  3. Choose Run now, follow each step’s log and output, and get notified when it finishes.