scriptoriumadmin/fabro
1
0
Fork 0
mirror of https://github.com/fabro-sh/fabro.git synced 2026-08-28 05:27:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Merge branch 'docs/update-models-and-cli-reference'

Browse source
This commit is contained in:
Bryan Helmkamp 2026-03-19 15:12:39 -04:00
commit a7040875cb
3 changed files with 27 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.claude/skills/docs/watermark
View file

@ -1 +1 @@
d6fdeb81353d3bdf86a87fc499a2a5889206524b 45ff3da4e05c7c67c909d7b860c7764b34e6a342

9
docs/core-concepts/models.mdx
View file

@ -14,7 +14,8 @@ No single model is best at everything. Fabro lets you assign the right model to
| Model | Provider | Aliases | Context | Cost (in/out per Mtok) | Speed | | Model | Provider | Aliases | Context | Cost (in/out per Mtok) | Speed |
|---|---|---|---|---|---| |---|---|---|---|---|---|
| `claude-opus-4-6` | anthropic | `opus`, `claude-opus` | 1M | $15.00 / $75.00 | 25 tok/s | | `claude-opus-4-6` | anthropic | `opus`, `claude-opus` | 1M | $15.00 / $75.00 | 25 tok/s |
| `claude-sonnet-4-5` | anthropic | `sonnet`, `claude-sonnet` | 200K | $3.00 / $15.00 | 50 tok/s | | `claude-sonnet-4-6` | anthropic | `sonnet`, `claude-sonnet` | 200K | $3.00 / $15.00 | 50 tok/s |
| `claude-sonnet-4-5` | anthropic | | 200K | $3.00 / $15.00 | 50 tok/s |
| `claude-haiku-4-5` | anthropic | `haiku`, `claude-haiku` | 200K | $0.80 / $4.00 | 100 tok/s | | `claude-haiku-4-5` | anthropic | `haiku`, `claude-haiku` | 200K | $0.80 / $4.00 | 100 tok/s |
| `gpt-5.2` | openai | `gpt5` | 1M | $1.80 / $14.00 | 65 tok/s | | `gpt-5.2` | openai | `gpt5` | 1M | $1.80 / $14.00 | 65 tok/s |
| `gpt-5-mini` | openai | `gpt5-mini` | 1M | $0.20 / $2.00 | 70 tok/s | | `gpt-5-mini` | openai | `gpt5-mini` | 1M | $0.20 / $2.00 | 70 tok/s |
@ -37,12 +38,12 @@ Each provider requires its own API key set via environment variable (e.g. `ANTHR
## Default models ## Default models
When no model is specified, the `fabro exec` command uses a default model based on the provider: When no model or provider is specified, Fabro auto-detects the provider by checking which API keys are configured, using precedence order Anthropic > OpenAI > Gemini. If no keys are found, it falls back to Anthropic. Each provider has a default model:
| Provider | Default model | | Provider | Default model |
|---|---| |---|---|
| `anthropic` | `claude-opus-4-6` | | `anthropic` | `claude-sonnet-4-6` |
| `openai` | `gpt-5.2-codex` | | `openai` | `gpt-5.4` |
| `gemini` | `gemini-3.1-pro-preview` | | `gemini` | `gemini-3.1-pro-preview` |
| `kimi` | `kimi-k2.5` | | `kimi` | `kimi-k2.5` |
| `zai` | `glm-4.7` | | `zai` | `glm-4.7` |

22
docs/reference/cli.mdx
View file

@ -143,7 +143,7 @@ fabro exec "Refactor the auth module" --permissions full --auto-approve
| Argument / Flag | Description | Default | | Argument / Flag | Description | Default |
|---|---|---| |---|---|---|
| `<PROMPT>` | Task prompt (required) | — | | `<PROMPT>` | Task prompt (required) | — |
| `--provider <PROVIDER>` | LLM provider | `anthropic` | | `--provider <PROVIDER>` | LLM provider | Auto-detected from configured API keys (see [default models](/core-concepts/models#default-models)) |
| `--model <MODEL>` | Model name | Per provider (see below) | | `--model <MODEL>` | Model name | Per provider (see below) |
| `--permissions <LEVEL>` | Permission level: `read-only`, `read-write`, or `full` | `read-write` | | `--permissions <LEVEL>` | Permission level: `read-only`, `read-write`, or `full` | `read-write` |
| `--auto-approve` | Skip interactive prompts; deny tools outside permission level | — | | `--auto-approve` | Skip interactive prompts; deny tools outside permission level | — |
@ -690,14 +690,34 @@ fabro asset cp <RUN_ID>:report.html ./output # specific file
When copying all assets in flat mode, filenames must be unique across nodes. Use `--tree` or `--node` to disambiguate. When copying all assets in flat mode, filenames must be unique across nodes. Use `--tree` or `--node` to disambiguate.
## `fabro provider login`
Re-authenticate with an LLM provider without re-running the full install wizard. Useful when tokens expire or when switching accounts.
```bash
fabro provider login --provider openai
fabro provider login --provider anthropic
```
| Flag | Description |
|---|---|
| `--provider <PROVIDER>` | LLM provider to authenticate with (required) |
For OpenAI, this launches a browser-based OAuth PKCE flow with an automatic fallback to manual API key entry. All other providers prompt for an API key with validation. Credentials are merged non-destructively into `~/.fabro/.env`.
## `fabro install` ## `fabro install`
Interactive setup wizard that walks you through configuring API keys and validating your environment. Runs `fabro doctor` with live probes after setup to validate the configuration. Interactive setup wizard that walks you through configuring API keys and validating your environment. Runs `fabro doctor` with live probes after setup to validate the configuration.
```bash ```bash
fabro install fabro install
fabro install --web-url https://fabro.example.com
``` ```
| Flag | Description | Default |
|---|---|---|
| `--web-url <URL>` | Web UI base URL for OAuth callback endpoints | `http://localhost:5173` |
--- ---
## `fabro secret set` ## `fabro secret set`