@slahon/lazykit 1.2.6 → 1.2.8

package/README.md

@@ -14,15 +14,18 @@ You describe what you want. Claude ships it.
 npx @slahon/lazykit@latest init
 ```
 
-Run this inside your project folder. That's it. LazyKit handles everything else automatically.
+Run this from your **project's root directory** — the same folder that contains your `.git` folder and has a GitHub remote configured. That's it. LazyKit handles everything else automatically.
 
 ## Requirements
 
 - Node.js 18+
-- A GitHub repository with a remote set up
+- A GitHub repository with a remote set up (`git remote -v` should show a GitHub URL)
 - A Claude Pro or Max subscription ([claude.ai](https://claude.ai))
 - Claude Code installed locally (`npm install -g @anthropic-ai/claude-code`)
 - GitHub CLI (`gh`) — required for full automation (`brew install gh` / [cli.github.com](https://cli.github.com))
+- **Claude Code GitHub App** installed on your repo — [github.com/apps/claude](https://github.com/apps/claude) *(required for the Actions workflow to run)*
+
+> **All `npx @slahon/lazykit` commands must be run from your project's root directory** — the folder where your `.git` directory lives and your GitHub remote is configured.
 
 ## How it works
 
@@ -72,6 +75,7 @@ Running `npx @slahon/lazykit@latest init` fully sets up your repo — no manual
 | Creates label | Creates the trigger label on GitHub |
 | Enables PR creation | Grants Actions permission to open pull requests |
 | Sets token | Runs `claude setup-token` and stores it as `CLAUDE_CODE_OAUTH_TOKEN` in your repo secrets |
+| GitHub App | Prompts you to install the Claude Code GitHub App on your repo |
 | Commits and pushes | Commits all generated files and pushes to GitHub |
 
 ## Commands
@@ -120,7 +124,6 @@ During `npx @slahon/lazykit@latest init` you will be asked:
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| Label name | `lazykit` | The GitHub label that triggers Claude |
 | Auto-trigger | Yes | Trigger Claude on every new issue, or only when you apply the label |
 | Generate CLAUDE.md | Yes | Create a project guide for Claude |
 

package/init.js

@@ -229,9 +229,22 @@ async function init({ dryRun = false } = {}) {
     }
   }
 
+  // ─── Step 11: Install Claude Code GitHub App ──────────────────────────────
+  if (!dryRun) {
+    console.log('\n' + chalk.bold.white('  📦 Install the Claude Code GitHub App\n'));
+    console.log(chalk.gray('  The workflow requires the Claude Code GitHub App installed on your repo.'));
+    console.log(chalk.gray('  Without it, the Actions run will fail with a 401 error.\n'));
+    console.log('  ' + chalk.bold.cyan('→ https://github.com/apps/claude') + '\n');
+    console.log(chalk.gray('  Click "Install" → select your account → grant access to this repo.'));
+    console.log(chalk.gray('  Takes about 30 seconds.\n'));
+    await confirm('Installed the GitHub App? (press Enter to continue)', true);
+  } else {
+    log.info('[dry-run] Would prompt: install Claude Code GitHub App at https://github.com/apps/claude');
+  }
+
   log.divider();
 
-  // ─── Step 11: Commit and push ──────────────────────────────────────────────
+  // ─── Step 12: Commit and push ──────────────────────────────────────────────
   if (dryRun) {
     log.info('[dry-run] Would commit and push generated files');
     log.blank();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slahon/lazykit",
-  "version": "1.2.6",
+  "version": "1.2.8",
   "description": "Drop an issue, get a PR. AI-powered issue-to-PR automation using Claude.",
   "bin": {
     "lazykit": "./index.js"

package/status.js

@@ -107,6 +107,10 @@ async function status() {
     log.success("No branch protection on main — Claude's PRs can be merged directly");
   }
 
+  log.blank();
+  log.info(`Claude Code GitHub App: verify it's installed at ${chalk.cyan(`https://github.com/apps/claude`)}`);
+  log.info('  If the Actions run fails with a 401 error, the app is not installed.');
+
   console.log();
 }