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 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
- fathom intake "Users need real-time chat and the Zoom integration is broken" --project myapp
74
- # Extracts discrete work items, classifies each by complexity/priority,
75
- # estimates tokens + cost per item, attaches velocity benchmarks,
76
- # outputs structured markdown spec ready for implementation
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
- # From text
134
- fathom intake "Users say the calendar is slow and Zoom links are missing" --project myapp
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
- # From a file
137
- fathom intake --file meeting-notes.md --project myapp --markdown
144
+ # Pipe-friendly markdown to stdout
145
+ fathom intake --file feedback.md --markdown
138
146
  ```
139
147
 
140
- Requires `ANTHROPIC_API_KEY` environment variable.
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 |