@bobbyg603/mog 1.5.1 → 1.5.2
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 +44 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,10 +11,13 @@ mog workingdevshero/automate-it 123
|
|
|
11
11
|
|
|
12
12
|
That's it. `mog` will:
|
|
13
13
|
|
|
14
|
-
1. Fetch the issue title, description, and
|
|
14
|
+
1. Fetch the issue title, description, labels, and comments via `gh` CLI
|
|
15
15
|
2. Create a git worktree on a clean branch (`123-fix-broken-login`)
|
|
16
16
|
3. Run Claude Code inside a persistent Docker sandbox (microVM) with `--dangerously-skip-permissions`
|
|
17
|
-
4.
|
|
17
|
+
4. **Plan** — analyze the codebase and create an implementation plan
|
|
18
|
+
5. **Build** — execute each task in the plan, one at a time
|
|
19
|
+
6. **Review** — self-review all changes for missed patterns, duplication, and quality
|
|
20
|
+
7. Squash commits, push the branch, and open a PR that `Closes #123`
|
|
18
21
|
|
|
19
22
|
## Prerequisites
|
|
20
23
|
|
|
@@ -57,12 +60,37 @@ If your session ever expires, just run `mog init` again to re-authenticate.
|
|
|
57
60
|
# One-time setup
|
|
58
61
|
mog init
|
|
59
62
|
|
|
60
|
-
#
|
|
61
|
-
mog
|
|
63
|
+
# Auto-detect repo from git remote (run from inside a git repo)
|
|
64
|
+
mog 123
|
|
62
65
|
|
|
63
|
-
#
|
|
64
|
-
mog
|
|
65
|
-
|
|
66
|
+
# Explicit repo
|
|
67
|
+
mog owner/repo 123
|
|
68
|
+
|
|
69
|
+
# Include files the project needs at runtime (e.g. .env, credentials)
|
|
70
|
+
# Files are copied into the worktree and removed before pushing
|
|
71
|
+
mog 123 --include .env --include serviceAccountKey.json
|
|
72
|
+
|
|
73
|
+
# List open issues
|
|
74
|
+
mog list
|
|
75
|
+
mog list --verbose
|
|
76
|
+
mog owner/repo list --verbose
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Re-mogging
|
|
80
|
+
|
|
81
|
+
Running `mog` again on an issue that already has an open PR will:
|
|
82
|
+
|
|
83
|
+
1. Fetch review comments and feedback from the existing PR
|
|
84
|
+
2. Include that feedback in the prompt so Claude addresses it
|
|
85
|
+
3. Start fresh from the default branch
|
|
86
|
+
4. Force-push to update the existing PR
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# Re-mog after getting PR feedback — Claude sees reviewer comments
|
|
90
|
+
mog 123
|
|
91
|
+
|
|
92
|
+
# Start completely over, ignoring the existing PR
|
|
93
|
+
mog 123 --fresh
|
|
66
94
|
```
|
|
67
95
|
|
|
68
96
|
## How it works
|
|
@@ -71,7 +99,8 @@ mog sparx-tech/hub-firmware 45
|
|
|
71
99
|
┌──────────────────────────────────────────────────────────┐
|
|
72
100
|
│ Host machine │
|
|
73
101
|
│ │
|
|
74
|
-
│ 1. gh issue view #123 → fetch title, body, labels
|
|
102
|
+
│ 1. gh issue view #123 → fetch title, body, labels, │
|
|
103
|
+
│ comments, and PR review feedback (if re-mogging) │
|
|
75
104
|
│ 2. git worktree add → clean branch from default branch │
|
|
76
105
|
│ │
|
|
77
106
|
│ ┌────────────────────────────────────────────────────┐ │
|
|
@@ -80,12 +109,14 @@ mog sparx-tech/hub-firmware 45
|
|
|
80
109
|
│ │ • ~/mog-repos mounted as workspace │ │
|
|
81
110
|
│ │ • Auth persists across runs (login once) │ │
|
|
82
111
|
│ │ • Isolated from host (own Docker daemon) │ │
|
|
83
|
-
│ │ •
|
|
84
|
-
│ │ •
|
|
112
|
+
│ │ • Phase 1: Plan — analyze codebase, create plan │ │
|
|
113
|
+
│ │ • Phase 2: Build — execute tasks one at a time │ │
|
|
114
|
+
│ │ • Phase 3: Review — self-review for quality │ │
|
|
85
115
|
│ └────────────────────────────────────────────────────┘ │
|
|
86
116
|
│ │
|
|
87
|
-
│ 3.
|
|
88
|
-
│ 4.
|
|
117
|
+
│ 3. Squash commits into one │
|
|
118
|
+
│ 4. git push origin branch (force-push if updating PR) │
|
|
119
|
+
│ 5. gh pr create --body "Closes #123" (or update PR) │
|
|
89
120
|
└──────────────────────────────────────────────────────────┘
|
|
90
121
|
```
|
|
91
122
|
|
|
@@ -94,7 +125,7 @@ mog sparx-tech/hub-firmware 45
|
|
|
94
125
|
| Environment Variable | Default | Description |
|
|
95
126
|
|---|---|---|
|
|
96
127
|
| `MOG_REPOS_DIR` | `~/mog-repos` | Where repos are cloned and worktrees created (also the sandbox workspace) |
|
|
97
|
-
| `MOG_MAX_ITERATIONS` | `
|
|
128
|
+
| `MOG_MAX_ITERATIONS` | `30` | Max build loop iterations per issue |
|
|
98
129
|
| `MOG_MAX_CONTINUATIONS` | — | Legacy alias for `MOG_MAX_ITERATIONS` |
|
|
99
130
|
|
|
100
131
|
## Worktree management
|