troth-dev 0.16.0
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 +89 -0
- package/dist/cli.js +2070 -0
- package/package.json +67 -0
package/README.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# troth-dev
|
|
2
|
+
|
|
3
|
+
Troth is a spec-driven task manager for AI coding agents. Write a feature specification, decompose it into executable tasks with file scopes and verification gates, and let Claude Code run them autonomously.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
Run without installing:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx troth-dev init
|
|
11
|
+
# or
|
|
12
|
+
bunx troth-dev init
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Or install globally:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npm install -g troth-dev
|
|
19
|
+
# or
|
|
20
|
+
bun add -g troth-dev
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Then initialize any project:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
troth init
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Getting started
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
troth init # set up .jig/ in the current repo
|
|
33
|
+
troth login # authenticate with Troth cloud
|
|
34
|
+
troth bootstrap # scan the codebase and seed specs
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Working with specs and tasks
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
troth spec list # list all specs
|
|
41
|
+
troth spec show <name> # view a spec
|
|
42
|
+
troth spec new <name> # create a new spec
|
|
43
|
+
|
|
44
|
+
troth decompose <spec> # break a spec into tasks
|
|
45
|
+
troth tasks <spec> # list tasks for a spec
|
|
46
|
+
troth task show <spec> <task>
|
|
47
|
+
troth task start <spec> <task>
|
|
48
|
+
troth task done <spec> <task> --notes "..."
|
|
49
|
+
|
|
50
|
+
troth next # ready tasks
|
|
51
|
+
troth next --parallel 3 # conflict-free tasks for parallel dispatch
|
|
52
|
+
troth status # project-wide status
|
|
53
|
+
troth guide # full workflow reference
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Run `troth help` or `troth <command> --help` for the full CLI.
|
|
57
|
+
|
|
58
|
+
## How it works
|
|
59
|
+
|
|
60
|
+
1. **Write specs** — describe features in markdown with intent, acceptance criteria, and constraints
|
|
61
|
+
2. **Decompose** — Troth breaks specs into executable tasks with file scopes and verification gates
|
|
62
|
+
3. **Execute** — Claude Code runs tasks autonomously, guided by rich context
|
|
63
|
+
4. **Verify** — automated verification gates confirm each task meets its criteria
|
|
64
|
+
|
|
65
|
+
## MCP server
|
|
66
|
+
|
|
67
|
+
Troth ships a hosted Model Context Protocol server at `mcp.usejig.dev` for use from claude.ai web conversations. From Claude Code, use the `troth` CLI directly — do not call MCP tools.
|
|
68
|
+
|
|
69
|
+
Health check:
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
curl https://mcp.usejig.dev/health
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Full operator notes (deploys, graceful shutdown, SSE tuning) live in `docs/`.
|
|
76
|
+
|
|
77
|
+
## Requirements
|
|
78
|
+
|
|
79
|
+
- Node.js 18+ or Bun 1.0+
|
|
80
|
+
- Claude Code CLI (for task execution)
|
|
81
|
+
|
|
82
|
+
## Links
|
|
83
|
+
|
|
84
|
+
- Docs: <https://docs.usejig.dev>
|
|
85
|
+
- Site: <https://usejig.dev>
|
|
86
|
+
|
|
87
|
+
## License
|
|
88
|
+
|
|
89
|
+
MIT
|