Skip to content

FIREHOSE DOCUMENTATION

Glossary

Read as Markdown

Look up an unfamiliar term, then return to the step where you encountered it.

Suppose you ask an agent to fix blank greetings. That is your task. You choose a provider, such as Codex, and a model, the AI system it uses to produce responses. Your session keeps the conversation with that agent together.

The agent explains the change in one turn. You ask it to add a missing test; it works again in another turn. Both turns belong to the same session and task.

Context is the conversation and other information available to the agent when it responds. If you clear conversation context, do not assume earlier chat instructions will carry into the next request. Put essential constraints in the new request. Clearing context is separate from changing files; see Smart Review’s context choice.

TermMeaning
AgentThe coding assistant that reads files, responds, and can take actions allowed by its settings
ProviderThe agent system you choose to handle requests, such as Claude or Codex
ModelThe AI system selected within a provider to generate responses; the choices depend on your installation
SessionYour ongoing conversation with one agent, associated with a project workspace
TaskThe result you want, such as fixing blank greetings; it may take several requests
TurnA period of agent work following input, ending when it returns control or stops
ContextInformation available for the next response, including the conversation so far and relevant material the agent has read
ApprovalA decision about whether the agent may perform a requested action
QuestionnaireA set of task questions answered in the Ask me tab; submitting them tells the agent to continue the requested work
TermMeaning
ProjectThe repository you choose to work on
RepositoryFiles together with their Git history
WorkspaceThe directory and branch selected for a session
CheckoutWorking files for a Git branch or revision
WorktreeAn additional checkout with its own directory, sharing the repository’s Git history
BranchA named line of changes recorded in Git
DiffDifferences between two versions of files
CommitA recorded snapshot of changes in Git
StagedChanges selected for the next Git commit
UnstagedEdits to tracked files that have not been selected for the next commit
UntrackedA file Git is not tracking yet
ServerThe machine running Firehose and your agent sessions
TailnetThe Tailscale network used to connect your devices
SSHA separate terminal login to another machine; it requires its own access

See What you can do for tasks and Find the right tool for controls.