fathom-cli 0.1.4 → 0.1.7
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 +27 -9
- package/dist/index.js +618 -426
- package/dist/index.js.map +1 -1
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -52,6 +52,7 @@ fathom velocity --project myapp
|
|
|
52
52
|
| `fathom status` | Project overview with tracking data |
|
|
53
53
|
| `fathom pricing` | Show current model pricing |
|
|
54
54
|
| `fathom setup` | Scaffold `.claude/` skill + hooks + registry |
|
|
55
|
+
| `fathom rename <name>` | Rename project across all config files |
|
|
55
56
|
| `fathom validate <spec>` | Validate spec file format |
|
|
56
57
|
| `fathom init` | Initialize global config |
|
|
57
58
|
|
|
@@ -70,12 +71,16 @@ fathom estimate "Build a real-time chat system with WebSocket support"
|
|
|
70
71
|
**`intake`** — full spec sheet from raw feedback:
|
|
71
72
|
|
|
72
73
|
```bash
|
|
73
|
-
|
|
74
|
-
#
|
|
75
|
-
|
|
76
|
-
|
|
74
|
+
# Interactive mode — auto-detects project, shows local files to pick from,
|
|
75
|
+
# prompts where to save the spec
|
|
76
|
+
fathom intake
|
|
77
|
+
|
|
78
|
+
# Or pass everything directly
|
|
79
|
+
fathom intake --file meeting-notes.md -o intake-specs/sprint-plan.md
|
|
77
80
|
```
|
|
78
81
|
|
|
82
|
+
Intake auto-detects your project name from `.claude/te/config.json`, scans the current directory for markdown files to offer as input, and saves specs to `intake-specs/` by default (configurable). Remembers your preferred output directory for next time.
|
|
83
|
+
|
|
79
84
|
Use `estimate` when you want a quick number. Use `intake` when you want a plan.
|
|
80
85
|
|
|
81
86
|
Both use a calibrated model: base tokens per task type × complexity multiplier × overhead (context resend, tool calls, thinking, error recovery, planning, review).
|
|
@@ -130,17 +135,30 @@ See the [full repo](https://github.com/olivelliott/fathom) for dashboard setup.
|
|
|
130
135
|
Turn raw feedback into estimated, structured work items:
|
|
131
136
|
|
|
132
137
|
```bash
|
|
133
|
-
#
|
|
134
|
-
fathom intake
|
|
138
|
+
# Interactive — detects files in cwd, prompts for everything
|
|
139
|
+
fathom intake
|
|
140
|
+
|
|
141
|
+
# Direct — pass input and output explicitly
|
|
142
|
+
fathom intake --file meeting-notes.md -o intake-specs/plan.md
|
|
135
143
|
|
|
136
|
-
#
|
|
137
|
-
fathom intake --file
|
|
144
|
+
# Pipe-friendly — markdown to stdout
|
|
145
|
+
fathom intake --file feedback.md --markdown
|
|
138
146
|
```
|
|
139
147
|
|
|
140
|
-
|
|
148
|
+
When run interactively, intake will:
|
|
149
|
+
1. Auto-detect your project name (or prompt + save it)
|
|
150
|
+
2. List markdown/text files in your current directory to pick from
|
|
151
|
+
3. Show a results table, then ask where to save the spec
|
|
152
|
+
4. Remember your preferred output directory for next time
|
|
153
|
+
|
|
154
|
+
Output is a buildable markdown spec with task checkboxes, acceptance criteria, priority grouping, and cost estimates.
|
|
155
|
+
|
|
156
|
+
Requires `ANTHROPIC_API_KEY` environment variable (auto-loaded from `.env`).
|
|
141
157
|
|
|
142
158
|
## Environment Variables
|
|
143
159
|
|
|
160
|
+
Fathom auto-loads `.env` files from the current directory, so you can set these in your project's `.env` instead of exporting them globally.
|
|
161
|
+
|
|
144
162
|
| Variable | Required | Purpose |
|
|
145
163
|
|----------|----------|---------|
|
|
146
164
|
| `ANTHROPIC_API_KEY` | For `estimate` + `intake` | AI complexity scoring and work item extraction |
|