Skip to content

FIREHOSE DOCUMENTATION

Projects, agents, and settings

Read as Markdown

Find the settings that control which projects you see and where a new session runs.

To open Settings, select the gear icon labeled Settings at the bottom of the icon rail on the far left. On a phone, go back to the session list first; the icon rail appears only there. Settings opens in the sidebar.

Open Settings and scroll to Project directories, near the bottom of the panel. Enter a comma-separated list of directories to scan, such as:

~/dev, ~/projects

These paths refer to the machine running Firehose. ~ is supported. Keep existing entries you still need, then select Save and look for Saved.

If a project is missing, check its location on the server and the configured parent directory before trying project troubleshooting.

The Choose an agent step, the last step after you select New session (the + at the top of the Sessions sidebar), lets you select the agent, model, and autonomy for that session.

Use provider and usage guidance to confirm account readiness and interpret usage indicators. Use the models listed by your installation. The selected provider’s models may need time to load, and a model marked unavailable can prevent the session from starting. Read its explanation and select an available option.

The wizard initializes autonomy as enabled. Read Choose agent permissions for the meanings of Claude’s —dangerously-skip-permissions, Codex’s Full Auto, and Antigravity’s separate editing and terminal controls. Check the displayed value before starting.

For the hosted app, use Settings → Server connection to manage the selected server. Switching lets you return to a previous server’s stored workspace. Forget this server deletes that server’s stored workspace after confirmation.

See Connect to Firehose for address requirements and tab behavior.

Settings → Open from your other devices turns tailnet access on and off with Allow my other devices. When it is on, it shows the address to open from your phone or another computer, with a Copy button. Only the Tailscale account that owns this computer can connect. If it says Restart Firehose to apply this., select Restart now. See Connect to Firehose.

Settings → Tailscale HTTPS shows the status of the HTTPS certificate used for remote access. Use it to investigate a missing, expired, or mismatched certificate. Restart Firehose after certificate installation or renewal.

You don’t need to change these settings to complete the everyday session guides on the Firehose computer itself.