prjct-cli 2.23.14 → 2.23.16
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/CHANGELOG.md +10 -0
- package/README.md +21 -21
- package/dist/bin/prjct-core.mjs +250 -250
- package/dist/daemon/entry.mjs +168 -168
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -81,6 +81,16 @@
|
|
|
81
81
|
|
|
82
82
|
## [Unreleased]
|
|
83
83
|
|
|
84
|
+
## [2.23.16] - 2026-05-20
|
|
85
|
+
|
|
86
|
+
### Added
|
|
87
|
+
- current work
|
|
88
|
+
|
|
89
|
+
## [2.23.15] - 2026-05-20
|
|
90
|
+
|
|
91
|
+
### Added
|
|
92
|
+
- Audit followups 2: regression tests para prompt-injection, exec hardening defense-in-depth, legacy-crew-sweep env gate
|
|
93
|
+
|
|
84
94
|
## [2.23.14] - 2026-05-20
|
|
85
95
|
|
|
86
96
|
### Added
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# prjct
|
|
1
|
+
# prjct-cli
|
|
2
2
|
|
|
3
|
-
**Project memory + quality workflows for AI coding agents.** prjct gives Claude Code (and any agent) durable memory of your projects: decisions, learnings, gotchas, hot files, recurring bugs. Plus 5 named quality workflows (review, qa, security, investigate, ship) that persist findings back to memory so the next session compounds.
|
|
3
|
+
**Project memory + quality workflows for AI coding agents.** prjct-cli gives Claude Code (and any agent) durable memory of your projects: decisions, learnings, gotchas, hot files, recurring bugs. Plus 5 named quality workflows (review, qa, security, investigate, ship) that persist findings back to memory so the next session compounds.
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/prjct-cli)
|
|
6
6
|
[]()
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
Copy this prompt and paste it in Claude Code (works for fresh install AND upgrade — Claude picks YOUR package manager, doesn't force npm):
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
Install or upgrade prjct on this machine. First detect which package manager I use globally (check `command -v pnpm`, `command -v bun`, `command -v yarn`, `command -v npm` in that order; also check where any existing `prjct` install lives via `command -v prjct` and use the SAME package manager so we don't create parallel installs). Then run the matching install:
|
|
15
|
+
Install or upgrade prjct-cli on this machine. First detect which package manager I use globally (check `command -v pnpm`, `command -v bun`, `command -v yarn`, `command -v npm` in that order; also check where any existing `prjct` install lives via `command -v prjct` and use the SAME package manager so we don't create parallel installs). Then run the matching install:
|
|
16
16
|
- pnpm: `pnpm install -g prjct-cli@latest`
|
|
17
17
|
- bun: `bun install -g prjct-cli@latest`
|
|
18
18
|
- yarn: `yarn global add prjct-cli@latest`
|
|
@@ -35,9 +35,9 @@ curl -sSL https://raw.githubusercontent.com/jlopezlira/prjct-cli/main/scripts/in
|
|
|
35
35
|
|
|
36
36
|
The script auto-detects platform (mac arm64/intel + linux x64), downloads the right binary from GitHub Releases, sets up `~/.local/bin/prjct` on your PATH, runs `prjct setup` + `prjct sync`, and warns you if a stale package-manager install is shadowing the new binary.
|
|
37
37
|
|
|
38
|
-
### Updating prjct (built-in)
|
|
38
|
+
### Updating prjct-cli (built-in)
|
|
39
39
|
|
|
40
|
-
prjct updates itself. The canonical command is **`prjct update`**, with
|
|
40
|
+
prjct-cli updates itself. The canonical command is **`prjct update`**, with
|
|
41
41
|
**`prjct upgrade`** as an identical alias:
|
|
42
42
|
|
|
43
43
|
```bash
|
|
@@ -61,7 +61,7 @@ What it does, in three phases (`core/commands/update.ts`):
|
|
|
61
61
|
Flags: `--dry-run`, `--yes`/`-y`, `--cleanup` / `--no-cleanup` (default `auto`),
|
|
62
62
|
`--md` (machine-readable output for agents/CI).
|
|
63
63
|
|
|
64
|
-
**Knowing an update exists:** prjct checks at most once every 24h (cached, fully
|
|
64
|
+
**Knowing an update exists:** prjct-cli checks at most once every 24h (cached, fully
|
|
65
65
|
non-blocking — never delays a command) and, after the command's own output,
|
|
66
66
|
prints a one-line banner: `Update available! x.y.z → a.b.c — Run: prjct upgrade`.
|
|
67
67
|
Or set it and forget it: `prjct config set auto-update on` (throttled background
|
|
@@ -71,7 +71,7 @@ Full install + upgrade paths: [INSTALL_PROMPT.md](./INSTALL_PROMPT.md).
|
|
|
71
71
|
|
|
72
72
|
### Native dependency repair
|
|
73
73
|
|
|
74
|
-
prjct uses SQLite for local project memory. On Node installs, that requires the
|
|
74
|
+
prjct-cli uses SQLite for local project memory. On Node installs, that requires the
|
|
75
75
|
`better-sqlite3` native binding. The package install, `prjct install`, and
|
|
76
76
|
daemon startup all verify the binding and retry `npm rebuild better-sqlite3`
|
|
77
77
|
when needed. If a locked-down sandbox blocks the rebuild, install still
|
|
@@ -79,7 +79,7 @@ continues and the daemon retries the repair the next time it starts.
|
|
|
79
79
|
|
|
80
80
|
## What you get
|
|
81
81
|
|
|
82
|
-
After install, **next session in any prjct project**:
|
|
82
|
+
After install, **next session in any prjct-cli project**:
|
|
83
83
|
|
|
84
84
|
- **Lookup-first protocol**: Claude reads `~/Documents/prjct/<slug>/_generated/` (architecture, patterns, decisions, gotchas, recent ships) BEFORE re-exploring source. Cuts ~10K tokens of exploration per session.
|
|
85
85
|
- **Auto-capture**: Stop hook scans the assistant transcript and persists durable insights (decisions/learnings/gotchas) tagged for dedup. The next session finds them in the vault.
|
|
@@ -97,7 +97,7 @@ After install, **next session in any prjct project**:
|
|
|
97
97
|
State lives in **SQLite** at `~/.prjct-cli/projects/<id>/`. The vault at `~/Documents/prjct/<slug>/_generated/` is an auto-regenerated Markdown snapshot — agent-readable via `Read`/`Glob`, browsable in Obsidian.
|
|
98
98
|
|
|
99
99
|
```
|
|
100
|
-
Claude Code session prjct
|
|
100
|
+
Claude Code session prjct-cli
|
|
101
101
|
| |
|
|
102
102
|
| SessionStart hook fires |
|
|
103
103
|
| --------------------------------> | self-heal CLAUDE.md, regen vault
|
|
@@ -178,7 +178,7 @@ In Claude Code, ask naturally:
|
|
|
178
178
|
Optional flags:
|
|
179
179
|
```bash
|
|
180
180
|
prjct config set auto-update on # silent self-update (1/hour throttled)
|
|
181
|
-
prjct team --enforce # pre-commit hook blocks commits without prjct
|
|
181
|
+
prjct team --enforce # pre-commit hook blocks commits without prjct-cli
|
|
182
182
|
```
|
|
183
183
|
|
|
184
184
|
## Inside Claude Code / Gemini CLI
|
|
@@ -255,7 +255,7 @@ Remove with `prjct claude uninstall` (hooks only) or `prjct uninstall` (everythi
|
|
|
255
255
|
|
|
256
256
|
## MCP Server
|
|
257
257
|
|
|
258
|
-
prjct exposes an MCP server with 5 tool groups:
|
|
258
|
+
prjct-cli exposes an MCP server with 5 tool groups:
|
|
259
259
|
|
|
260
260
|
| Group | Tools |
|
|
261
261
|
|---|---|
|
|
@@ -265,7 +265,7 @@ prjct exposes an MCP server with 5 tool groups:
|
|
|
265
265
|
| **workflow** | list, run, log |
|
|
266
266
|
| **code-intel** | related, impact, stale |
|
|
267
267
|
|
|
268
|
-
The broker model: if you already have `linear`, `jira`, `posthog`, `gmail` MCPs wired, prjct **does not duplicate them** — it tells your agent they're available for the current persona and caches your insights locally.
|
|
268
|
+
The broker model: if you already have `linear`, `jira`, `posthog`, `gmail` MCPs wired, prjct-cli **does not duplicate them** — it tells your agent they're available for the current persona and caches your insights locally.
|
|
269
269
|
|
|
270
270
|
## CLI
|
|
271
271
|
|
|
@@ -339,7 +339,7 @@ A combined ranker fuses the three signals (`core/domain/file-ranker.ts`) and pow
|
|
|
339
339
|
|
|
340
340
|
## Issue Tracker Integration
|
|
341
341
|
|
|
342
|
-
Bring your own MCP — prjct doesn't duplicate trackers.
|
|
342
|
+
Bring your own MCP — prjct-cli doesn't duplicate trackers.
|
|
343
343
|
|
|
344
344
|
- **Linear**: configure the official Linear MCP in your agent and declare it in `persona.mcps`.
|
|
345
345
|
- **Jira**: same — use the official Atlassian MCP.
|
|
@@ -387,7 +387,7 @@ prjct-cli/
|
|
|
387
387
|
## Common questions
|
|
388
388
|
|
|
389
389
|
**How do I initialize / register a new project?**
|
|
390
|
-
In any git repo, run `prjct sync` (it auto-runs on the first prjct command) or
|
|
390
|
+
In any git repo, run `prjct sync` (it auto-runs on the first `prjct` command) or
|
|
391
391
|
`prjct init`. This creates `.prjct/prjct.config.json` with a `projectId`, builds
|
|
392
392
|
the SQLite store at `~/.prjct-cli/projects/<projectId>/`, and generates the vault.
|
|
393
393
|
|
|
@@ -411,7 +411,7 @@ argument prints the currently active task.
|
|
|
411
411
|
|
|
412
412
|
**How do I get AI assistance for a coding problem?**
|
|
413
413
|
Inside Claude Code (or any wired agent) describe the problem in natural
|
|
414
|
-
language — prjct maps the intent to a quality workflow and runs its methodology,
|
|
414
|
+
language — prjct-cli maps the intent to a quality workflow and runs its methodology,
|
|
415
415
|
persisting findings to memory. Concrete examples:
|
|
416
416
|
|
|
417
417
|
| You say… | Workflow activated | What it does |
|
|
@@ -426,7 +426,7 @@ project use?" and the agent reads `~/Documents/prjct/<slug>/_generated/patterns.
|
|
|
426
426
|
instead of grepping source (the lookup-first protocol). Outside an agent, every
|
|
427
427
|
command takes `--md` to emit agent-ready markdown.
|
|
428
428
|
|
|
429
|
-
**What does prjct output look like in a normal terminal?**
|
|
429
|
+
**What does prjct-cli output look like in a normal terminal?**
|
|
430
430
|
A branded, **animated** spinner with full colors and interactive prompts (the
|
|
431
431
|
native human experience). See [What it looks like](#what-it-looks-like).
|
|
432
432
|
|
|
@@ -434,9 +434,9 @@ native human experience). See [What it looks like](#what-it-looks-like).
|
|
|
434
434
|
`prjct update` (alias `prjct upgrade`) — auto-detects your package manager, pins
|
|
435
435
|
the true registry-latest, consolidates parallel installs, restarts the daemon.
|
|
436
436
|
A non-blocking 24h-cached banner tells you when one is available. See
|
|
437
|
-
[Updating prjct](#updating-prjct-built-in).
|
|
437
|
+
[Updating prjct-cli](#updating-prjct-cli-built-in).
|
|
438
438
|
|
|
439
|
-
**How does prjct tailor its output for Claude Code specifically?**
|
|
439
|
+
**How does prjct-cli tailor its output for Claude Code specifically?**
|
|
440
440
|
Once it detects Claude (env vars / MCP / `CLAUDE.md` / `~/.claude/`) and sees
|
|
441
441
|
piped stdio (non-TTY), it adapts on every axis, with no flag:
|
|
442
442
|
|
|
@@ -457,7 +457,7 @@ Full per-environment table: [docs/environments.md](./docs/environments.md).
|
|
|
457
457
|
|
|
458
458
|
**What's the output in an OpenAI Codex sandbox?**
|
|
459
459
|
Codex is detected by the `codex` CLI on PATH (context file `AGENTS.md`). The
|
|
460
|
-
sandbox is non-interactive/non-TTY, so prjct emits the same static, prompt-free
|
|
460
|
+
sandbox is non-interactive/non-TTY, so prjct-cli emits the same static, prompt-free
|
|
461
461
|
status line as any agent; add `--md` for fully markdown-structured output.
|
|
462
462
|
|
|
463
463
|
**How do I quickly find the local `.prjct/` directory?**
|
|
@@ -478,10 +478,10 @@ the *other* tiers: DB at `~/.prjct-cli/projects/<projectId>/prjct.db`, vault at
|
|
|
478
478
|
base). The in-repo `.prjct/` holds only config, not state — full detail in
|
|
479
479
|
[docs/storage-and-paths.md](./docs/storage-and-paths.md).
|
|
480
480
|
|
|
481
|
-
**How does prjct detect its environment with no configuration?**
|
|
481
|
+
**How does prjct-cli detect its environment with no configuration?**
|
|
482
482
|
Every signal is something the host sets itself — Claude exports env vars and
|
|
483
483
|
pipes stdio, Codex puts `codex` on PATH, a real terminal has a TTY, CI doesn't.
|
|
484
|
-
prjct reads those ambient facts (precedence in
|
|
484
|
+
prjct-cli reads those ambient facts (precedence in
|
|
485
485
|
[docs/environments.md](./docs/environments.md)) rather than asking you to declare
|
|
486
486
|
anything.
|
|
487
487
|
|