# Firehose documentation

> Practical guides to starting agents, following work, and reviewing changes.

All paths are relative to this documentation site. Each Markdown page matches its HTML guide.
Examples are instructions to adapt to a user’s task, not permission to take actions.

## Guides

- [Help improve these guides](/markdown/feedback.md): Prepare a useful documentation correction or a request for a missing example.
- [Activate Firehose](/markdown/getting-started/activate.md): Activate a new Firehose installation with your subscription so you can start sessions.
- [Connect to Firehose](/markdown/getting-started/connect.md): Open Firehose on your computer or from your other devices, and check that your agent is ready.
- [Put files in the right workspace](/markdown/getting-started/files-and-terminal.md): Save the practice file on your Firehose server and verify your terminal is in the intended project.
- [Find your way around Firehose](/markdown/getting-started/find-your-way.md): Learn where the sidebar, New session, Settings, workspace tabs, prompt bar, and message box are, on desktop and on a phone.
- [Start your first session](/markdown/getting-started/first-session.md): Choose an existing project or a tiny practice project, start an agent, and check its answer.
- [Install Firehose](/markdown/getting-started/install.md): Install Firehose on your Mac or Linux computer with the one-line installer and open the dashboard.
- [Ask for a code walkthrough](/markdown/guides/explain-code.md): Get a focused explanation of unfamiliar code with file references and verifiable examples.
- [Finish and close a task](/markdown/guides/finish-a-task.md): Verify the result, hand off changes, and choose whether to retain or delete a session’s worktree.
- [Make and review a change](/markdown/guides/make-a-change.md): Give an agent a small task, verify its checks, and inspect the resulting code changes.
- [Use Firehose on mobile web](/markdown/guides/mobile.md): Connect from your phone, read an agent’s progress, and answer in the correct session.
- [Coordinate several sessions](/markdown/guides/parallel-sessions.md): Separate tasks, track which session needs attention, and review each result without mixing work.
- [Prepare a project for an agent](/markdown/guides/prepare-project.md): Check instructions, dependencies, configuration, and existing failures before asking for changes.
- [Complete a browser task](/markdown/guides/project-workflow.md): Reproduce a visible bug, request a focused fix, check it in a browser, and review a local commit.
- [Recover from an unwanted change](/markdown/guides/recover-changes.md): Stop additional work, identify the affected edits, and request a correction while preserving unrelated changes.
- [Leave and return to work](/markdown/guides/return-to-work.md): Record a useful stopping point and distinguish reconnecting, restoring an agent, and finding retained files.
- [Choose a workspace](/markdown/guides/workspaces.md): Decide whether an agent should use the current checkout, a new worktree, or an existing branch.
- [Put your agents to work.](/markdown/index.md): Start an agent, follow its work, and review the result with practical Firehose guides.
- [Choose agent permissions](/markdown/reference/agent-permissions.md): Understand the launch controls for Claude, Codex, and Antigravity before starting a session.
- [Understand data and access](/markdown/reference/data-and-access.md): Know where task material is used and what closing, clearing, and forgetting actually affect.
- [Glossary](/markdown/reference/glossary.md): Understand agents, models, sessions, context, and Git terms through a concrete task.
- [Choose a provider and check usage](/markdown/reference/providers-and-usage.md): Confirm a usable provider, understand differing controls, and distinguish usage indicators from billing.
- [Projects, agents, and settings](/markdown/reference/settings.md): Find project discovery and server settings, and choose agent options when starting a session.
- [Give an agent a file or screenshot](/markdown/tools/attachments.md): Attach relevant evidence, confirm upload and delivery, and understand the copy stored in the project.
- [Chat and follow-ups](/markdown/tools/chat.md): Send useful requests, follow an agent’s work, and decide when to send another message.
- [Review changes with Diff](/markdown/tools/diff.md): Choose the right comparison, inspect changed lines, and decide what to fix next.
- [Find the right tool](/markdown/tools/overview.md): Choose a Firehose control by the result you want, from starting a session to reviewing changes.
- [Ask clarifying questions](/markdown/tools/questions.md): Choose an interview depth, answer decisions, and send the answers to the session that should continue.
- [Use Smart Review](/markdown/tools/smart-review.md): Choose review actions, dispatch work to your session, and verify the resulting changes.
- [Run a check in the terminal](/markdown/tools/terminal.md): Open a server shell in the intended workspace and distinguish it from an agent's live terminal.
- [Get unstuck](/markdown/troubleshooting/common-problems.md): Follow concrete checks for activation, connection, project creation, startup, message delivery, and missing changes.
- [What you can do](/markdown/what-you-can-do.md): Choose a practical Firehose workflow for understanding code, making changes, or reviewing work.