prjct-cli 2.53.0 → 2.54.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/CHANGELOG.md +15 -0
- package/bin/prjct +20 -0
- package/dist/bin/prjct-core.mjs +369 -415
- package/dist/daemon/entry.mjs +297 -302
- package/dist/mcp/server.mjs +203 -203
- package/dist/templates.json +1 -1
- package/package.json +1 -1
- package/templates/agents/AGENTS.md +13 -29
- package/templates/antigravity/SKILL.md +4 -4
- package/templates/codex/SKILL.md +2 -2
- package/templates/cursor/router.mdc +1 -1
- package/templates/global/ANTIGRAVITY.md +2 -2
- package/templates/global/CURSOR.mdc +2 -2
- package/templates/global/GEMINI.md +2 -2
- package/templates/global/STORAGE-SPEC.md +1 -1
- package/templates/global/WINDSURF.md +2 -2
- package/templates/windsurf/router.md +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AGENTS.md
|
|
2
2
|
|
|
3
|
-
AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Works with Claude Code, Gemini CLI, and
|
|
3
|
+
AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Works with Claude Code, Codex, Gemini CLI, OpenCode, Qwen Code, Cline, Cursor, Windsurf, and any AGENTS.md-aware runtime.
|
|
4
4
|
|
|
5
5
|
## What This Is
|
|
6
6
|
|
|
@@ -10,31 +10,15 @@ AI assistant guidance for **prjct-cli** - context layer for AI coding agents. Wo
|
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## Agent Contract
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
```javascript
|
|
18
|
-
await generator.generateDynamicAgent('agent-name', {
|
|
19
|
-
role: 'Role Description',
|
|
20
|
-
expertise: 'Technologies, versions, tools',
|
|
21
|
-
responsibilities: 'What they handle'
|
|
22
|
-
})
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### Guidelines
|
|
26
|
-
1. Read `analysis/repo-summary.md` first
|
|
27
|
-
2. Create specialists for each major technology
|
|
28
|
-
3. Name descriptively: `go-backend` not `be`
|
|
29
|
-
4. Include versions and frameworks found
|
|
30
|
-
5. Follow project-specific patterns
|
|
15
|
+
Run `prjct <command> --md` and follow the CLI output. Prefer `prjct_*` MCP tools when the active client exposes them.
|
|
31
16
|
|
|
32
17
|
## Architecture
|
|
33
18
|
|
|
34
19
|
**Global**: `~/.prjct-cli/projects/{id}/`
|
|
35
20
|
```
|
|
36
21
|
prjct.db # SQLite database (all state)
|
|
37
|
-
context/ # now.md, next.md
|
|
38
22
|
agents/ # domain specialists
|
|
39
23
|
```
|
|
40
24
|
|
|
@@ -44,21 +28,21 @@ agents/ # domain specialists
|
|
|
44
28
|
|
|
45
29
|
| Command | Action |
|
|
46
30
|
|---------|--------|
|
|
47
|
-
| `
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
31
|
+
| `prjct init` | Initialize |
|
|
32
|
+
| `prjct sync --md` | Analyze + refresh agent context |
|
|
33
|
+
| `prjct task "X" --md` | Start task |
|
|
34
|
+
| `prjct status done --md` | Complete active task |
|
|
35
|
+
| `prjct ship --md` | Ship feature |
|
|
36
|
+
| `prjct status --md` | Show current task/workflow state |
|
|
53
37
|
|
|
54
38
|
## Intent Detection
|
|
55
39
|
|
|
56
40
|
| Intent | Command |
|
|
57
41
|
|--------|---------|
|
|
58
|
-
| Start task | `
|
|
59
|
-
| Finish | `
|
|
60
|
-
| Ship | `
|
|
61
|
-
| What's
|
|
42
|
+
| Start task | `prjct task "<desc>" --md` |
|
|
43
|
+
| Finish | `prjct status done --md` |
|
|
44
|
+
| Ship | `prjct ship --md` |
|
|
45
|
+
| What's active | `prjct status --md` |
|
|
62
46
|
|
|
63
47
|
## Implementation
|
|
64
48
|
|
|
@@ -7,16 +7,16 @@ description: Use when user mentions p., prjct, task tracking, or workflow comman
|
|
|
7
7
|
|
|
8
8
|
Grammar: `p. <command> [args]` or `prjct <command> --md`
|
|
9
9
|
|
|
10
|
-
Core commands: sync, task,
|
|
11
|
-
Integrations: linear, jira
|
|
10
|
+
Core commands: sync, task, status, ship, bug, workflow, spec, guard, capture, remember, context
|
|
11
|
+
Integrations: linear, jira
|
|
12
12
|
Other: run `prjct <command> --md` and follow CLI output
|
|
13
13
|
|
|
14
|
-
Flow: idea →
|
|
14
|
+
Flow: idea → spec when warranted → task → work → status done → ship
|
|
15
15
|
|
|
16
16
|
Rules:
|
|
17
17
|
- Persist everything (memories, captures, specs) in ENGLISH, whatever language the user speaks
|
|
18
18
|
- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
|
|
19
19
|
- All commits include footer: `Generated with [p/](https://www.prjct.app/)`
|
|
20
20
|
- All storage through `prjct` CLI (SQLite internally)
|
|
21
|
-
- Start code tasks with `
|
|
21
|
+
- Start code tasks with `prjct task "<desc>" --md` and follow the CLI output
|
|
22
22
|
- Worktree hygiene: if working in a git worktree, remove it AFTER its PR merges — `git worktree remove` from the main worktree; never with uncommitted/unpushed work, never `--force`
|
package/templates/codex/SKILL.md
CHANGED
|
@@ -7,10 +7,10 @@ description: Use when the user mentions p., prjct, tasks, specs, shipping, or pr
|
|
|
7
7
|
|
|
8
8
|
Run `prjct <command> --md` and follow its output. Pull context on demand; never dump it all.
|
|
9
9
|
|
|
10
|
-
- Flow: `task` → work → `done` → `ship`
|
|
10
|
+
- Flow: `prjct task` → work → `prjct status done` → `prjct ship`
|
|
11
11
|
- Memory (write in ENGLISH always): `prjct remember <decision|gotcha|learning|fact> "<text>"`, `prjct context memory <topic>` (recall), `prjct guard <file>` (preventive memory before editing)
|
|
12
12
|
- Capture stray thoughts: `prjct capture "<text>"`
|
|
13
13
|
- Worktrees: remove only AFTER the PR merges, from the main worktree; never with unpushed work.
|
|
14
|
-
-
|
|
14
|
+
- `prjct --help` lists commands; prefer prjct MCP tools (`prjct_*`) when available.
|
|
15
15
|
|
|
16
16
|
Commit footer: `Generated with [p/](https://www.prjct.app/)`
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
|
|
2
2
|
# p/ — Context layer for AI agents
|
|
3
3
|
|
|
4
|
-
Skills auto-activate for: task,
|
|
4
|
+
Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
|
|
5
5
|
Other commands: run `prjct <command> --md` and follow CLI output
|
|
6
6
|
|
|
7
|
-
Flow: idea →
|
|
7
|
+
Flow: idea → spec when warranted → task → work → status done → ship
|
|
8
8
|
|
|
9
9
|
Data:
|
|
10
10
|
- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
|
|
@@ -6,10 +6,10 @@ alwaysApply: true
|
|
|
6
6
|
<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
|
|
7
7
|
# p/ — Context layer for AI agents
|
|
8
8
|
|
|
9
|
-
Skills auto-activate for: task,
|
|
9
|
+
Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
|
|
10
10
|
Other commands: run `prjct <command> --md` and follow CLI output
|
|
11
11
|
|
|
12
|
-
Flow: idea →
|
|
12
|
+
Flow: idea → spec when warranted → task → work → status done → ship
|
|
13
13
|
|
|
14
14
|
Data:
|
|
15
15
|
- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
|
|
2
2
|
# p/ — Context layer for AI agents
|
|
3
3
|
|
|
4
|
-
Skills auto-activate for: task,
|
|
4
|
+
Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
|
|
5
5
|
Other commands: run `prjct <command> --md` and follow CLI output
|
|
6
6
|
|
|
7
|
-
Flow: idea →
|
|
7
|
+
Flow: idea → spec when warranted → task → work → status done → ship
|
|
8
8
|
|
|
9
9
|
Data:
|
|
10
10
|
- Persist everything (memories, captures, specs) in ENGLISH, whatever language the user speaks
|
|
@@ -269,7 +269,7 @@ prjctDb.setDoc(projectId, 'key', data)
|
|
|
269
269
|
p. task "add feature X"
|
|
270
270
|
|
|
271
271
|
# Switch to Gemini, continue
|
|
272
|
-
|
|
272
|
+
prjct status done --md # Should work seamlessly
|
|
273
273
|
|
|
274
274
|
# Switch back to Claude
|
|
275
275
|
p. ship # Should read Gemini's changes correctly
|
|
@@ -6,10 +6,10 @@ description: "prjct - Context layer for AI coding agents"
|
|
|
6
6
|
<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
|
|
7
7
|
# p/ — Context layer for AI agents
|
|
8
8
|
|
|
9
|
-
Skills auto-activate for: task,
|
|
9
|
+
Skills auto-activate for: task, status, ship, sync, bug, workflow, spec, guard, capture, remember, context, linear, jira
|
|
10
10
|
Other commands: run `prjct <command> --md` and follow CLI output
|
|
11
11
|
|
|
12
|
-
Flow: idea →
|
|
12
|
+
Flow: idea → spec when warranted → task → work → status done → ship
|
|
13
13
|
|
|
14
14
|
Data:
|
|
15
15
|
- prjct runs → LLM generates relevant data → prjct stores it → LLM requests it from prjct → LLM uses it
|
|
@@ -5,5 +5,5 @@ description: "prjct - Context layer for AI coding agents"
|
|
|
5
5
|
|
|
6
6
|
# prjct
|
|
7
7
|
|
|
8
|
-
Core: /sync, /task, /
|
|
8
|
+
Core: /sync, /task, /status, /ship, /bug, /workflow, /spec, /guard
|
|
9
9
|
Other: run `prjct <command> --md` and follow CLI output
|