Skip to content

FIREHOSE DOCUMENTATION

Find the right tool

Read as Markdown

Find the control you need for your next step. Firehose’s controls organize the work; the commands your agent can run also depend on its provider and permissions.

You provide: a project, workspace, provider, model, and permission choices. You get: a session in the selected directory on your server.

Have a configured provider and a project ready. Start your first session or choose a workspace for a separate task.

You provide: a task, a follow-up, or an answer. You get: the agent’s response and activity.

Check the selected project and branch before sending. Use Chat to follow the work and understand delivery notices.

You provide: a topic through tools → Ask me questions on the prompt bar, an interview depth, and your answers in the Ask me tab. You get: a combined answer message for the selected session in that worktree.

Use a session where Chat input is available and check for an unfinished questionnaire first. Answer clarifying questions.

You choose: a comparison and a file. You get: changed lines, file contents, or commit details.

Select the Diff tab at the top of a session associated with a Git repository. Review with Diff to distinguish working edits from branch commits.

You provide: branch changes, optional focus areas, and decisions on findings. You get: an assessment and follow-up work after you dispatch your choices with Act.

Start one from tools → Smart review on the prompt bar, and read it in the Smart Review tab. It needs committed branch changes, an available agent, and a usable review base such as origin/main. For the standalone greeting sample, use Diff and its checks. Use Smart Review, then finish the task.

You provide: a server directory and a command. You get: live command output in a server shell, in the Terminal tab at the top of a session. Run a terminal check and distinguish a separate shell from the agent’s live terminal.

You provide: a file or screenshot and a request explaining its relevance. You get: a staged copy available to the selected agent. Attach evidence and check upload, delivery, and the response separately.

The prompt bar’s commit button, shown when the branch has uncommitted changes, opens a list grouped as Staged, Unstaged, and Untracked. Selecting Commit requests agent work; the list is not a per-file selection interface. For mixed edits, give explicit scope in Chat and verify the resulting commit. Follow the local commit walkthrough.

Team Chat, X-Ray, Timeline, voice, and issue workflows still need complete verified walkthroughs. Their presence in an installation does not mean this guide covers their prerequisites or outcomes.