ptbk 0.112.0-98 → 0.112.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/README.md +38 -18
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -27,6 +27,26 @@ Create persistent AI agents that turn your company's scattered knowledge into ac
|
|
|
27
27
|
|
|
28
28
|
|
|
29
29
|
|
|
30
|
+
### Standalone VPS
|
|
31
|
+
|
|
32
|
+
Run the standalone VPS installer only on a fresh server. Interactive mode asks for the installation values:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Non-interactive mode takes defaults from command-line options. When `--openai-api-key` is provided with the default OpenAI Codex runner, the installer installs and configures Codex automatically; other runner authentication can be configured later from the UI or SSH:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash -s -- \
|
|
42
|
+
--non-interactive \
|
|
43
|
+
--yes-i-understand-that-script-should-be-run-on-fresh-server \
|
|
44
|
+
--domain s24.ptbk.io \
|
|
45
|
+
--openai-api-key sk-proj-abcdef \
|
|
46
|
+
--sentry-dsn https://abc@def.ingest.de.sentry.io/123 \
|
|
47
|
+
--admin-password xxx
|
|
48
|
+
```
|
|
49
|
+
|
|
30
50
|
|
|
31
51
|
|
|
32
52
|
|
|
@@ -396,9 +416,9 @@ Prompts marked with `[-]` are not ready yet, prompts containing `@@@` are treate
|
|
|
396
416
|
#### Features
|
|
397
417
|
|
|
398
418
|
- **Multi-runner execution:** `openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`
|
|
399
|
-
- **Context injection:** `--context AGENTS.md` or inline extra instructions
|
|
419
|
+
- **Context injection:** `--agent agents/coding/developer.book --context AGENTS.md` or inline extra instructions
|
|
400
420
|
- **Reasoning control:** `--thinking-level low|medium|high|xhigh` for supported runners
|
|
401
|
-
- **
|
|
421
|
+
- **Unattended or interactive runs:** default auto mode, or `--no-auto` to wait for user confirmation before each prompt
|
|
402
422
|
- **Git safety:** clean working tree check by default, optional `--ignore-git-changes`
|
|
403
423
|
- **Opt-in remote pushes:** commits stay local unless you explicitly pass `--auto-push`
|
|
404
424
|
- **Prompt triage:** `--priority` to process only more important tasks first
|
|
@@ -416,11 +436,11 @@ npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompt
|
|
|
416
436
|
|
|
417
437
|
npx ts-node ./src/cli/test/ptbk.ts coder generate-boilerplates --template prompts/templates/agents-server.md
|
|
418
438
|
|
|
419
|
-
npx ts-node ./src/cli/test/ptbk.ts coder run --
|
|
439
|
+
npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md
|
|
420
440
|
|
|
421
|
-
npx ts-node ./src/cli/test/ptbk.ts coder run --
|
|
441
|
+
npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
|
|
422
442
|
|
|
423
|
-
npx ts-node ./src/cli/test/ptbk.ts coder run --
|
|
443
|
+
npx ts-node ./src/cli/test/ptbk.ts coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --ignore-git-changes
|
|
424
444
|
|
|
425
445
|
npx ts-node ./src/cli/test/ptbk.ts coder find-refactor-candidates
|
|
426
446
|
|
|
@@ -442,11 +462,11 @@ ptbk coder generate-boilerplates
|
|
|
442
462
|
|
|
443
463
|
ptbk coder generate-boilerplates --template prompts/templates/common.md
|
|
444
464
|
|
|
445
|
-
ptbk coder run --
|
|
465
|
+
ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test
|
|
446
466
|
|
|
447
|
-
ptbk coder run --
|
|
467
|
+
ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --auto-push
|
|
448
468
|
|
|
449
|
-
ptbk coder run --
|
|
469
|
+
ptbk coder run --harness github-copilot --model gpt-5.4 --thinking-level xhigh --agent agents/coding/developer.book --context AGENTS.md --test npm run test --ignore-git-changes
|
|
450
470
|
|
|
451
471
|
ptbk coder find-refactor-candidates
|
|
452
472
|
|
|
@@ -459,24 +479,24 @@ ptbk coder verify
|
|
|
459
479
|
|
|
460
480
|
#### What each command does
|
|
461
481
|
|
|
462
|
-
| Command | What it does
|
|
463
|
-
| ------------------------------------- |
|
|
482
|
+
| Command | What it does |
|
|
483
|
+
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
|
|
464
484
|
| `ptbk coder init` | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
|
|
465
|
-
| `ptbk coder generate-boilerplates` | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root.
|
|
466
|
-
| `ptbk coder run` | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.
|
|
467
|
-
| `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow
|
|
468
|
-
| `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.
|
|
485
|
+
| `ptbk coder generate-boilerplates` | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root. |
|
|
486
|
+
| `ptbk coder run` | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled. |
|
|
487
|
+
| `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
|
|
488
|
+
| `ptbk coder verify` | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results. |
|
|
469
489
|
|
|
470
490
|
#### Most useful `ptbk coder run` flags
|
|
471
491
|
|
|
472
492
|
| Flag | Purpose |
|
|
473
493
|
| -------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
474
|
-
| `--
|
|
494
|
+
| `--harness <name>` | Selects the coding harness. |
|
|
475
495
|
| `--model <model>` | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
|
|
476
496
|
| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`. |
|
|
477
497
|
| `--test <command>` | Runs a verification command after each prompt attempt and feeds failing output back for retries. |
|
|
478
498
|
| `--thinking-level <level>` | Sets reasoning effort for supported runners. |
|
|
479
|
-
| `--no-
|
|
499
|
+
| `--no-auto` | Waits for user confirmation before each prompt instead of running automatically through the queue. |
|
|
480
500
|
| `--ignore-git-changes` | Disables the clean-working-tree guard. |
|
|
481
501
|
| `--priority <n>` | Runs only prompts at or above the given priority. |
|
|
482
502
|
| `--dry-run` | Prints which prompts are ready instead of executing them. |
|
|
@@ -488,8 +508,8 @@ ptbk coder verify
|
|
|
488
508
|
|
|
489
509
|
1. Initialize once with `ptbk coder init`.
|
|
490
510
|
2. Customize `prompts/templates/*.md` if needed, then create or write prompt files in `prompts/`.
|
|
491
|
-
3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--context AGENTS.md`.
|
|
492
|
-
4. Run
|
|
511
|
+
3. Customize the starter `AGENTS.md` with repository-specific instructions, then pass `--agent agents/coding/developer.book --context AGENTS.md`.
|
|
512
|
+
4. Run unattended batches by default, or pass `--no-auto` to confirm each prompt interactively.
|
|
493
513
|
5. Finish with `ptbk coder verify` so resolved prompts are archived and broken ones get explicit repair follow-ups.
|
|
494
514
|
|
|
495
515
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ptbk",
|
|
3
|
-
"version": "0.112.0
|
|
3
|
+
"version": "0.112.0",
|
|
4
4
|
"description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
|
|
5
5
|
"private": false,
|
|
6
6
|
"sideEffects": false,
|
|
@@ -91,10 +91,10 @@
|
|
|
91
91
|
"zod": "$zod"
|
|
92
92
|
},
|
|
93
93
|
"peerDependencies": {
|
|
94
|
-
"@promptbook/core": "0.112.0
|
|
94
|
+
"@promptbook/core": "0.112.0"
|
|
95
95
|
},
|
|
96
96
|
"dependencies": {
|
|
97
|
-
"promptbook": "0.112.0
|
|
97
|
+
"promptbook": "0.112.0"
|
|
98
98
|
},
|
|
99
99
|
"bin": {
|
|
100
100
|
"ptbk": "bin/promptbook-cli-proxy.js"
|