@fermindi/pwn-cli 0.3.4 → 0.3.6

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/cli/update.js CHANGED
@@ -26,6 +26,7 @@ const FRAMEWORK_FILES = [
26
26
  */
27
27
  const CLAUDE_COMMANDS = [
28
28
  'save.md',
29
+ 'mode.md',
29
30
  ];
30
31
 
31
32
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fermindi/pwn-cli",
3
- "version": "0.3.4",
3
+ "version": "0.3.6",
4
4
  "description": "Professional AI Workspace - Inject structured memory and automation into any project for AI-powered development",
5
5
  "type": "module",
6
6
  "bin": {
@@ -0,0 +1,103 @@
1
+ # /mode - PWN Session Mode
2
+
3
+ Switch between interactive and batch modes, and configure batch execution settings.
4
+
5
+ ## Usage
6
+
7
+ ```
8
+ /mode Show current mode and batch config
9
+ /mode interactive Switch to interactive mode
10
+ /mode batch Switch to batch mode
11
+ /mode batch [options] Switch to batch with config changes
12
+ ```
13
+
14
+ ## Options (batch mode only)
15
+
16
+ | Option | Description |
17
+ |--------|-------------|
18
+ | `--max-tasks=N` | Maximum tasks per batch (default: 5) |
19
+ | `--max-hours=N` | Maximum duration in hours (default: 4) |
20
+ | `--quality-gates=X,Y,Z` | Quality gates to run (default: typecheck,lint,test) |
21
+ | `--auto-commit` | Enable auto commit (default) |
22
+ | `--no-auto-commit` | Disable auto commit |
23
+ | `--auto-push` | Enable auto push to remote |
24
+ | `--no-auto-push` | Disable auto push (default) |
25
+ | `--create-pr` | Enable PR creation |
26
+ | `--no-create-pr` | Disable PR creation (default) |
27
+ | `--reset` | Reset config to defaults |
28
+
29
+ ---
30
+
31
+ ## Instructions
32
+
33
+ Run the `pwn mode` CLI command with the user's arguments:
34
+
35
+ ```bash
36
+ pwn mode $ARGUMENTS
37
+ ```
38
+
39
+ If no arguments provided, run:
40
+
41
+ ```bash
42
+ pwn mode
43
+ ```
44
+
45
+ ### Examples
46
+
47
+ Show current mode:
48
+ ```bash
49
+ pwn mode
50
+ ```
51
+
52
+ Switch to batch:
53
+ ```bash
54
+ pwn mode batch
55
+ ```
56
+
57
+ Configure batch with options:
58
+ ```bash
59
+ pwn mode batch --max-tasks=3 --auto-push
60
+ ```
61
+
62
+ Switch to interactive:
63
+ ```bash
64
+ pwn mode interactive
65
+ ```
66
+
67
+ ---
68
+
69
+ ## Modes Explained
70
+
71
+ ### Interactive Mode (default)
72
+
73
+ - Claude responds to user requests conversationally
74
+ - Asks clarifying questions when needed
75
+ - Commits require explicit user approval
76
+ - Good for exploratory work and collaboration
77
+
78
+ ### Batch Mode
79
+
80
+ - Claude executes tasks autonomously from backlog
81
+ - Creates feature branches per task
82
+ - Runs quality gates before committing
83
+ - Continues until backlog empty or limits reached
84
+ - Good for repetitive tasks and overnight execution
85
+
86
+ ---
87
+
88
+ ## After Running
89
+
90
+ After executing the command, explain to the user:
91
+
92
+ 1. **Current mode** - What mode they're now in
93
+ 2. **Batch config** - Current batch settings (if relevant)
94
+ 3. **Next steps** - What they can do next
95
+
96
+ For batch mode, remind them:
97
+ - Add tasks to `.ai/tasks/backlog.md`
98
+ - Run `pwn batch` to start executing tasks
99
+ - Use `pwn batch status` to check progress
100
+
101
+ For interactive mode, remind them:
102
+ - Work proceeds conversationally
103
+ - Use `/save` to persist session state