Promote CLI commands to changelog heroes and improve framing

Promote fabro pr, fabro init, fabro diff, fabro preview, fabro graph,
user-level workflows, and GPT-5.4 Mini from accordion items to hero
sections. Reframe lifecycle hooks with positive language.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Bryan Helmkamp 2026-03-18 11:01:13 -04:00
parent 92c6a439ff
commit e12157cb57
No known key found for this signature in database
5 changed files with 57 additions and 16 deletions

View file

@ -1,5 +1,5 @@
---
title: "One-line installer, MCP servers, and devcontainer support"
title: "One-line installer, MCP servers, devcontainers, and new CLI commands"
date: "2026-03-10"
---
@ -38,6 +38,40 @@ devcontainer = true
**`--no-dotenv` flag removed.** Fabro now always loads `~/.fabro/.env` and never loads a local `./.env` file. If you were relying on project-local `.env` files, move those values to `~/.fabro/.env`.
</Warning>
## Manage PRs with fabro pr
`fabro pr list`, `fabro pr view`, `fabro pr merge`, and `fabro pr close` let you manage pull requests created by workflow runs without leaving the CLI. Pair with `fabro pr create` (introduced Mar 9) for the full lifecycle.
```bash
fabro pr list # list PRs from workflow runs
fabro pr view <run-id> # view PR details
fabro pr merge <run-id> # merge a workflow PR
```
## Scaffold projects with fabro init
`fabro init` generates a `fabro.toml` with sensible defaults for your project — workflow aliases, pull request config, and sandbox settings — so you can go from zero to `fabro run` in seconds.
```bash
fabro init
```
## View run diffs with fabro diff
`fabro diff` shows the code changes from any workflow run. It works on both completed and in-progress runs — for active runs, you get a live diff of the current state.
```bash
fabro diff <run-id>
```
## Preview sandbox URLs with fabro preview
`fabro preview` returns preview URLs for ports exposed by Daytona sandboxes, so you can open a running web app or service directly from the CLI.
```bash
fabro preview <run-id>
```
## More
<Accordion title="API">
@ -45,12 +79,8 @@ devcontainer = true
</Accordion>
<Accordion title="CLI">
- Added `fabro pr list/view/merge/close` subcommands for managing pull requests created by workflow runs
- Added `fabro init` command to scaffold new projects with a generated `fabro.toml`
- Added `fabro diff` command to view code changes from workflow runs, with live diffs for in-progress runs
- `fabro setup` renamed to `fabro install` for clarity
- Added `fabro ssh` command for direct SSH access to Daytona sandboxes
- Added `fabro preview` command to get preview URLs for ports exposed by Daytona sandboxes
- `fabro doctor` now runs live service probes by default; use `--dry-run` to skip
- `fabro doctor` now validates GitHub App configuration and private key
- `fabro doctor` now hides unconfigured LLM providers for a cleaner output

View file

@ -1,5 +1,5 @@
---
title: "SSH sandbox and skill installer"
title: "SSH sandbox, skill installer, and fabro graph"
date: "2026-03-11"
---
@ -32,10 +32,18 @@ fabro skill install --for user
After installation, AI assistants in your editor can use the skill when generating or editing Fabro workflows.
## Visualize workflows with fabro graph
`fabro graph` renders your workflow DOT graphs as SVG or PNG, so you can see the full structure of your workflow at a glance. Requires Graphviz `dot` to be installed.
```bash
fabro graph # SVG to stdout
fabro graph -o flow.png # PNG to file
```
## More
<Accordion title="CLI">
- Added `fabro graph` subcommand to render workflow DOT graphs as SVG or PNG (requires Graphviz `dot`)
- `fabro run` and `fabro validate` now print the resolved workflow path before execution
- `fabro doctor` now groups checks into **Required**, **Optional**, and **Server** sections and shows a spinner while checks run
- Added warning during `fabro init` when no git remote is configured

View file

@ -20,11 +20,11 @@ graph = "workflow.fabro"
Human-in-the-loop gates now show the previous stage's output before prompting, so you can see what the agent produced before deciding what to do next. Gates with only a freeform edge also skip the multiple-choice menu and go straight to a text input, making conversational loops like REPL workflows feel more natural.
## More
## User-level workflows
<Accordion title="CLI">
- Added user-level workflow lookup in `~/.fabro/workflows/` — personal workflows are now available across all projects
</Accordion>
Personal workflows stored in `~/.fabro/workflows/` are now available across all your projects. Drop a workflow into your home directory once and run it from anywhere with `fabro run <name>` — no need to copy it into each repo.
## More
<Accordion title="Workflows">
- New `thread_id_requires_fidelity_full` lint rule warns when `thread_id` is set without `fidelity=full`

View file

@ -1,5 +1,5 @@
---
title: "Auto-merge for PRs, lifecycle hooks, and styled workflow graphs"
title: "Auto-merge for PRs, three new lifecycle hooks, and styled workflow graphs"
date: "2026-03-16"
---
@ -13,9 +13,9 @@ auto_merge = true
merge_strategy = "squash"
```
## Lifecycle hooks fully wired
## Three new lifecycle hooks
Three hook events — `stage_retrying`, `parallel_start`, and `parallel_complete` — were previously defined and documented but never actually fired by the engine. They now trigger at the correct points: `stage_retrying` fires immediately before backoff sleep on both error-retry and explicit-retry paths, and the parallel hooks fire when parallel node groups start and finish execution. If you had hooks configured for these events that weren't running, they'll start working now.
Three new hook events are now available — `stage_retrying`, `parallel_start`, and `parallel_complete`. `stage_retrying` fires immediately before backoff sleep on both error-retry and explicit-retry paths, and the parallel hooks fire when parallel node groups start and finish execution.
## More

View file

@ -1,5 +1,5 @@
---
title: "Use Fabro with your OpenAI subscription"
title: "OpenAI OAuth support and GPT-5.4 Mini"
date: "2026-03-17"
---
@ -7,6 +7,10 @@ date: "2026-03-17"
Fabro now supports OpenAI OAuth — if you have an OpenAI Codex or ChatGPT subscription, you can sign in with your OpenAI account and use Fabro with your existing plan. Requests are routed through OpenAI's Codex backend API with streaming and provider-specific optimizations handled automatically.
## GPT-5.4 Mini support
`gpt-5.4-mini` is now available in the model catalog. Use it with `fabro model set gpt-5.4-mini` or set it per-workflow in your `workflow.toml`.
## More
<Accordion title="CLI">
@ -15,6 +19,5 @@ Fabro now supports OpenAI OAuth — if you have an OpenAI Codex or ChatGPT subsc
</Accordion>
<Accordion title="Improvements">
- Added `gpt-5.4-mini` to the model catalog
- DOT workflow syntax is now highlighted in the documentation with color-coded keywords, strings, and attributes
</Accordion>