@phren/cli 0.0.41 → 0.0.43
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/mcp/dist/cli/actions.js +1 -1
- package/mcp/dist/cli/cli.js +3 -1
- package/mcp/dist/cli/hooks-session.js +8 -8
- package/mcp/dist/cli/namespaces.js +110 -3
- package/mcp/dist/cli-hooks-session-handlers.js +8 -8
- package/mcp/dist/content/dedup.js +5 -2
- package/mcp/dist/entrypoint.js +4 -3
- package/mcp/dist/finding/context.js +3 -2
- package/mcp/dist/finding/journal.js +88 -1
- package/mcp/dist/init/config.js +1 -1
- package/mcp/dist/init/init-configure.js +1 -1
- package/mcp/dist/init/init-hooks-mode.js +1 -1
- package/mcp/dist/init/init-mcp-mode.js +2 -2
- package/mcp/dist/init/init-walkthrough.js +9 -9
- package/mcp/dist/init/init.js +8 -8
- package/mcp/dist/init/setup.js +6 -0
- package/mcp/dist/init-fresh.js +4 -4
- package/mcp/dist/init-hooks.js +1 -1
- package/mcp/dist/init-modes.js +3 -3
- package/mcp/dist/init-update.js +3 -3
- package/mcp/dist/init-walkthrough.js +9 -9
- package/mcp/dist/link/link.js +1 -1
- package/mcp/dist/phren-paths.js +2 -2
- package/mcp/dist/profile-store.js +2 -2
- package/mcp/dist/status.js +1 -1
- package/mcp/dist/tools/finding.js +37 -5
- package/mcp/dist/tools/search.js +81 -20
- package/mcp/dist/tools/session.js +10 -4
- package/mcp/dist/tools/tasks.js +78 -8
- package/mcp/dist/tools/types.js +22 -0
- package/package.json +1 -1
- package/skills/sync/SKILL.md +1 -1
- package/starter/README.md +6 -6
- package/starter/machines.yaml +1 -1
- package/starter/my-first-project/tasks.md +1 -1
- package/starter/templates/README.md +1 -1
package/skills/sync/SKILL.md
CHANGED
|
@@ -102,7 +102,7 @@ If this fails (not a git repo, no remote), tell the user. Don't silently skip.
|
|
|
102
102
|
Run init against the pulled phren repo so hooks, MCP registration, and machine/profile wiring are refreshed:
|
|
103
103
|
|
|
104
104
|
```bash
|
|
105
|
-
PHREN_PATH="$PHREN_DIR"
|
|
105
|
+
PHREN_PATH="$PHREN_DIR" phren init -y
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
If the user is in an untracked repo afterward, tell them to open a session there and let the agent ask, or run `phren add` from that directory.
|
package/starter/README.md
CHANGED
|
@@ -32,7 +32,7 @@ New to phren? Here's what each file does and when it matters.
|
|
|
32
32
|
|
|
33
33
|
**FINDINGS.md** fills itself. As Claude discovers insights, patterns, and decisions during your sessions, it tells phren and entries land here grouped by date. Old entries fade from retrieval over time. Wrong entries can be removed with `remove_finding()`.
|
|
34
34
|
|
|
35
|
-
**tasks.md** is your task board file. It keeps Active (working now), Queue (up next), and Done (finished) in one place so the work history stays with the project. You can also manage it from `
|
|
35
|
+
**tasks.md** is your task board file. It keeps Active (working now), Queue (up next), and Done (finished) in one place so the work history stays with the project. You can also manage it from `phren shell`.
|
|
36
36
|
|
|
37
37
|
**global/CLAUDE.md** applies everywhere. Your style preferences, tool choices, things Claude should always know regardless of which project you're in.
|
|
38
38
|
|
|
@@ -40,14 +40,14 @@ New to phren? Here's what each file does and when it matters.
|
|
|
40
40
|
|
|
41
41
|
## Getting started
|
|
42
42
|
|
|
43
|
-
If you got here via `npx phren init`, you're already set up. Restart Claude Code and you're good.
|
|
43
|
+
If you got here via `npx @phren/cli init`, you're already set up. Restart Claude Code and you're good.
|
|
44
44
|
|
|
45
45
|
If you cloned manually:
|
|
46
46
|
|
|
47
|
-
1. Add the MCP server: `claude mcp add phren -- npx phren ~/.phren`
|
|
47
|
+
1. Add the MCP server: `claude mcp add phren -- npx @phren/cli ~/.phren`
|
|
48
48
|
2. Install skills: `/plugin marketplace add alaarab/phren` then `/plugin install phren@phren`
|
|
49
49
|
3. Restart Claude Code
|
|
50
|
-
4. Add a project: run `/phren-init my-project` or scaffold one with a template such as `
|
|
50
|
+
4. Add a project: run `/phren-init my-project` or scaffold one with a template such as `phren init --template python-project`
|
|
51
51
|
5. Push to a private GitHub repo to sync across machines
|
|
52
52
|
|
|
53
53
|
## Day-to-day workflow
|
|
@@ -56,7 +56,7 @@ If you cloned manually:
|
|
|
56
56
|
2. **Work normally**: Claude reads your project docs and builds on what phren remembers
|
|
57
57
|
3. **Fragments accumulate**: tell phren what you learned, or he picks up insights automatically
|
|
58
58
|
4. **Session ends**: phren commits and pushes what he collected
|
|
59
|
-
5. **Review occasionally**: run `
|
|
59
|
+
5. **Review occasionally**: run `phren shell` to triage what phren queued, manage tasks, and check health
|
|
60
60
|
|
|
61
61
|
## Syncing across machines
|
|
62
62
|
|
|
@@ -71,4 +71,4 @@ Each profile in `profiles/` lists which projects that machine should see. After
|
|
|
71
71
|
|
|
72
72
|
## Troubleshooting
|
|
73
73
|
|
|
74
|
-
Run `
|
|
74
|
+
Run `phren doctor --fix` to check and repair your setup.
|
package/starter/machines.yaml
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# starter/templates/
|
|
2
2
|
|
|
3
|
-
Project templates bundled in the npm package, used by `
|
|
3
|
+
Project templates bundled in the npm package, used by `phren init --template <name>`.
|
|
4
4
|
|
|
5
5
|
Each subdirectory (frontend, library, monorepo, python-project) contains pre-filled project files with sensible defaults for that project type. When a user runs init with `--template`, these files are copied into their `~/.phren/<project>/` directory. For other project types, adaptive init infers topics and structure from repo content.
|
|
6
6
|
|