Skip to content

Commit 4b6003e

Browse files
committed
docs(prd): add 'Why Now' section on coding agents and CLIs
Coding agents prefer CLIs: text-native, self-documenting, composable, and already learned from training data. Positions Brev CLI as the default for autonomous GPU workflows.
1 parent 109e513 commit 4b6003e

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

docs/PRD-composable-cli.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,17 @@
44

55
Make the Brev CLI idiomatic, programmable, and agent-friendly. Users and AI agents should be able to compose commands using standard Unix patterns (`|`, `grep`, `awk`, `jq`) while also having structured output options for programmatic access.
66

7+
## Why Now
8+
9+
Coding agents (Claude Code, Cursor, Cline, Aider, OpenCode, Clawdbot) are becoming the primary interface between developers and their tools. These agents prefer CLIs over APIs:
10+
11+
- **Text-native** - LLMs think in text; pipes and grep are natural
12+
- **Self-documenting** - `--help` and tab completion beat reading API docs
13+
- **Composable** - Chain steps: `brev search | brev create | brev exec "setup.sh"`
14+
- **Learned from training** - Agents already know Unix conventions from GitHub/Stack Overflow
15+
16+
Most GPU clouds have dashboards and APIs, but weak CLIs. A composable Brev CLI becomes the default for autonomous GPU workflows.
17+
718
## Goals
819

920
1. **Unix Idiomatic** - Commands work naturally with pipes and standard tools

0 commit comments

Comments
 (0)