|
1 | 1 | # flowctl |
2 | 2 |
|
3 | | -A fast, native task and workflow engine for structured, plan-first development. Manages epics, tasks, dependencies, and state machines in a local `.flow/` directory backed by SQLite. |
| 3 | +A fast, native task and workflow engine for structured, plan-first development. Manages epics, tasks, dependencies, and state machines in a local `.flow/` directory backed by libSQL (async, native vector search). |
4 | 4 |
|
5 | 5 | flowctl is the Rust rewrite of the Python `flowctl` CLI from [flow-code](https://github.com/anthropics/flow-code), designed for speed, cross-platform support, and zero-dependency deployment. |
6 | 6 |
|
@@ -52,34 +52,17 @@ flowctl status |
52 | 52 | flowctl tasks -e ep-1 |
53 | 53 | ``` |
54 | 54 |
|
55 | | -## Feature flags |
56 | | - |
57 | | -| Flag | Crate | Effect | |
58 | | -|------|-------|--------| |
59 | | -| `tui` | flowctl-cli | Enables the TUI dashboard (`flowctl tui`) | |
60 | | -| `daemon` | flowctl-daemon | Enables the background daemon with HTTP API | |
61 | | -| `daemon` | flowctl-scheduler | Enables file-watcher integration | |
62 | | - |
63 | | -Build with all features: |
64 | | - |
65 | | -```sh |
66 | | -cargo build --release --all-features |
67 | | -``` |
68 | | - |
69 | 55 | ## Architecture |
70 | 56 |
|
71 | | -flowctl is split into six crates for modularity: |
| 57 | +flowctl is split into three crates: |
72 | 58 |
|
73 | 59 | ``` |
74 | | -flowctl-core Core types, ID parsing, state machine, YAML/JSON I/O |
75 | | -flowctl-db SQLite storage layer (rusqlite + migrations) |
76 | | -flowctl-scheduler DAG-based task scheduler and event bus |
| 60 | +flowctl-core Core types, ID parsing, state machine, DAG, JSON I/O |
| 61 | +flowctl-db libSQL storage layer (async, native vector search) |
77 | 62 | flowctl-cli CLI entry point (clap) — the `flowctl` binary |
78 | | -flowctl-daemon Background daemon: scheduler, file watcher, HTTP/WS API |
79 | | -flowctl-tui Terminal UI dashboard (ratatui) |
80 | 63 | ``` |
81 | 64 |
|
82 | | -**Data flow**: CLI parses commands via `clap`, calls into `flowctl-db` for storage, which uses `flowctl-core` types. The scheduler builds a DAG from task dependencies to determine execution order. The daemon wraps the scheduler with file watching and an HTTP API. The TUI provides a live dashboard. |
| 65 | +**Data flow**: CLI parses commands via `clap`, calls into `flowctl-db` for storage, which uses `flowctl-core` types. The DAG module computes task dependencies and execution order. |
83 | 66 |
|
84 | 67 | ## Release profile |
85 | 68 |
|
|
0 commit comments