CLI reference¶

The fountain binary manages Fountain resources from the terminal or CI scripts.

Install¶

brew install BinaryBourbon/tap/fountain

Or grab a release binary from the GitHub Releases page.

Authentication¶

fountain auth login        # prompts for email + password
fountain auth logout
fountain auth status

Target a non-default instance:

fountain auth login --endpoint https://your-fountain.example.com

Apply manifests¶

fountain apply -f path/to/manifest.yml
fountain apply -f path/to/directory/    # walks all *.yml / *.yaml files

Apply is idempotent - create if new, update if changed. Supported kinds: Environment, Vault, Agent.

Read resources¶

fountain get agents
fountain get environments
fountain get vaults
fountain get conversations

fountain get agent my-agent-name

Inspect a resource¶

fountain describe agent my-agent-name
fountain describe conversation <id>

Delete¶

fountain delete agent my-agent-name
fountain delete environment python-data-env

Start a conversation¶

fountain run agent my-agent-name --prompt "Audit the auth module"
fountain run agent my-agent-name --vault staging-creds --prompt "Run the test suite"

run streams log output until the conversation completes, then prints the final result.

Output formats¶

fountain get agents -o json
fountain get agents -o yaml
fountain get agents -o table   # default

Configuration file¶

~/.fountain/credentials is written by fountain auth login:

endpoint: https://founta.inevitable.fyi
token: ft_...

Per-invocation overrides:

FOUNTAIN_TOKEN=ft_... fountain get agents
FOUNTAIN_ENDPOINT=https://other.example.com fountain get agents