openthrottle 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# openthrottle
|
|
2
|
+
|
|
3
|
+
CLI for [Open Throttle](https://github.com/knoxgraeme/openthrottle) — ship prompts to autonomous coding agents running on Daytona sandboxes.
|
|
4
|
+
|
|
5
|
+
## Quick start
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx openthrottle init # one-time project setup
|
|
9
|
+
npx openthrottle ship docs/prds/auth.md # ship a prompt
|
|
10
|
+
npx openthrottle status # check running/queued tasks
|
|
11
|
+
npx openthrottle logs # view workflow runs
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Prerequisites
|
|
15
|
+
|
|
16
|
+
- [gh CLI](https://cli.github.com) installed and authenticated (`gh auth login`)
|
|
17
|
+
- A git repo with a GitHub remote
|
|
18
|
+
- `.openthrottle.yml` in the repo root (generated by `openthrottle init`)
|
|
19
|
+
|
|
20
|
+
## Commands
|
|
21
|
+
|
|
22
|
+
| Command | What it does |
|
|
23
|
+
|---|---|
|
|
24
|
+
| `init` | Detect your project, generate config, create Daytona snapshot |
|
|
25
|
+
| `ship <file.md> [--base branch]` | Create a GitHub issue to trigger a sandbox |
|
|
26
|
+
| `status` | Show running, queued, reviewing, and completed tasks |
|
|
27
|
+
| `logs` | Show recent GitHub Actions workflow runs |
|
|
28
|
+
|
|
29
|
+
## How it works
|
|
30
|
+
|
|
31
|
+
1. `openthrottle init` generates `.openthrottle.yml` and a GitHub Actions workflow
|
|
32
|
+
2. `openthrottle ship` creates a GitHub issue with the `prd-queued` label
|
|
33
|
+
3. The workflow creates an ephemeral Daytona sandbox
|
|
34
|
+
4. An agent (Claude, Codex, or Aider) implements the work and opens a PR
|
|
35
|
+
5. Sandbox auto-deletes when done
|
|
36
|
+
|
|
37
|
+
## License
|
|
38
|
+
|
|
39
|
+
MIT
|