runbook-cli 1.0.0

package/.runbook

@@ -0,0 +1,4 @@
+{
+  "dev": "npm run dev",
+  "build": "npm run build ; echo Build complete!"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Munene Mwirigi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+# runbook
+
+Remember project commands. Run them from anywhere.
+
+## The Problem
+
+Every project runs differently. You can't remember. You check the README every time.
+
+```bash
+# Is it...
+npm run dev
+# or
+npm start  
+# or
+pnpm dev
+# or  
+python manage.py runserver
+# or
+go run main.go
+```
+
+**Stop guessing. Stop checking.**
+
+## The Solution
+
+Set it once. Run it forever.
+
+```bash
+# Set commands
+runbook set dev "npm run dev"
+runbook set test "npm test"
+runbook set build "npm run build"
+
+# Run from anywhere in the project
+runbook dev
+
+# That's it.
+```
+
+## Install
+
+```bash
+npm install -g runbook-cli
+```
+
+## Usage
+
+### Set Commands
+
+```bash
+# Basic
+runbook set dev "npm run dev"
+
+# With install
+runbook set dev "npm install && npm run dev"
+
+# Backend
+runbook set start "python manage.py runserver"
+
+# Docker
+runbook set up "docker-compose up -d"
+
+# Multi-step
+runbook set deploy "npm run build && npm run test && git push"
+```
+
+### Run Commands
+
+```bash
+# Run a command
+runbook dev
+
+# Works from any subfolder
+cd src/components
+runbook dev  # Still works!
+
+# Short alias
+rb dev
+```
+
+### List Commands
+
+```bash
+# See all commands
+runbook list
+
+# Or just
+runbook
+```
+
+### Delete Commands
+
+```bash
+runbook delete dev
+# or
+runbook rm dev
+```
+
+### Project Info
+
+```bash
+runbook info
+```
+
+## How It Works
+
+- Finds your git root automatically
+- Stores commands in `.runbook` in project root
+- Works from any subfolder
+- Team shares via git (commit `.runbook`)
+
+## Example Workflow
+
+```bash
+# New project
+cd my-project
+runbook set dev "npm install && npm run dev"
+runbook set test "npm test"
+
+# 3 months later, can't remember
+runbook
+# Shows: dev, test
+
+runbook dev
+# Runs instantly
+
+# In subfolder
+cd src/pages
+runbook dev
+# Still works!
+```
+
+## Team Usage
+
+Commit `.runbook` to git:
+
+```bash
+git add .runbook
+git commit -m "Add runbook commands"
+```
+
+Now everyone runs:
+```bash
+runbook dev  # Works for everyone
+```
+
+## Commands Reference
+
+```bash
+runbook set <name> <command>   # Set a command
+runbook <name>                 # Run a command
+runbook list                   # List all commands
+runbook delete <name>          # Delete a command
+runbook info                   # Show project info
+runbook                        # Show available commands
+rb                             # Short alias
+```
+
+## Examples
+
+### Node.js
+```bash
+runbook set dev "npm install && npm run dev"
+runbook set build "npm run build"
+runbook set test "npm test"
+```
+
+### Python/Django
+```bash
+runbook set dev "pip install -r requirements.txt && python manage.py runserver"
+runbook set migrate "python manage.py migrate"
+runbook set shell "python manage.py shell"
+```
+
+### Go
+```bash
+runbook set dev "go run main.go"
+runbook set build "go build -o bin/app"
+runbook set test "go test ./..."
+```
+
+### Docker
+```bash
+runbook set up "docker-compose up -d"
+runbook set down "docker-compose down"
+runbook set logs "docker-compose logs -f"
+```
+
+### Full Stack
+```bash
+runbook set dev "docker-compose up -d && npm run dev"
+runbook set backend "cd backend && python manage.py runserver"
+runbook set frontend "cd frontend && npm start"
+```
+
+## Why runbook?
+
+- **No more README diving** - Commands right there
+- **Works everywhere** - Any subfolder, always works
+- **Team onboarding** - New dev runs `runbook dev`, done
+- **Cross-language** - Node, Python, Go, Rust - doesn't matter
+- **Zero config** - Just set and run
+
+## Data Storage
+
+Commands stored in `.runbook` in project root (JSON format).
+
+```json
+{
+  "dev": "npm run dev",
+  "test": "npm test",
+  "build": "npm run build"
+}
+```
+
+## License
+
+MIT
+
+## Author
+
+Built by [Brian Mwirigi](https://github.com/brian-mwirigi)
+
+---
+
+**Stop thinking. Start running.**

package/dist/commands.d.ts

@@ -0,0 +1,11 @@
+export interface RunbookCommands {
+    [key: string]: string;
+}
+export declare function getRunbookPath(): string;
+export declare function loadCommands(): RunbookCommands;
+export declare function saveCommands(commands: RunbookCommands): void;
+export declare function setCommand(name: string, command: string): void;
+export declare function getCommand(name: string): string | undefined;
+export declare function deleteCommand(name: string): boolean;
+export declare function listCommands(): RunbookCommands;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAID,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,wBAAgB,YAAY,IAAI,eAAe,CAa9C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAG5D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,wBAAgB,YAAY,IAAI,eAAe,CAE9C"}

package/dist/commands.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRunbookPath = getRunbookPath;
+exports.loadCommands = loadCommands;
+exports.saveCommands = saveCommands;
+exports.setCommand = setCommand;
+exports.getCommand = getCommand;
+exports.deleteCommand = deleteCommand;
+exports.listCommands = listCommands;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const git_1 = require("./git");
+const RUNBOOK_FILE = '.runbook';
+function getRunbookPath() {
+    const projectRoot = (0, git_1.getProjectRoot)();
+    return (0, path_1.join)(projectRoot, RUNBOOK_FILE);
+}
+function loadCommands() {
+    const runbookPath = getRunbookPath();
+    if (!(0, fs_1.existsSync)(runbookPath)) {
+        return {};
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(runbookPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return {};
+    }
+}
+function saveCommands(commands) {
+    const runbookPath = getRunbookPath();
+    (0, fs_1.writeFileSync)(runbookPath, JSON.stringify(commands, null, 2), 'utf-8');
+}
+function setCommand(name, command) {
+    const commands = loadCommands();
+    commands[name] = command;
+    saveCommands(commands);
+}
+function getCommand(name) {
+    const commands = loadCommands();
+    return commands[name];
+}
+function deleteCommand(name) {
+    const commands = loadCommands();
+    if (!(name in commands)) {
+        return false;
+    }
+    delete commands[name];
+    saveCommands(commands);
+    return true;
+}
+function listCommands() {
+    return loadCommands();
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":";;AAUA,wCAGC;AAED,oCAaC;AAED,oCAGC;AAED,gCAIC;AAED,gCAGC;AAED,sCAQC;AAED,oCAEC;AA1DD,2BAA6D;AAC7D,+BAA4B;AAC5B,+BAAuC;AAMvC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC,SAAgB,cAAc;IAC5B,MAAM,WAAW,GAAG,IAAA,oBAAc,GAAE,CAAC;IACrC,OAAO,IAAA,WAAI,EAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,YAAY;IAC1B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,QAAyB;IACpD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,IAAA,kBAAa,EAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY,EAAE,OAAe;IACtD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACzB,YAAY,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,3 @@
+export declare function findGitRoot(startPath?: string): string | null;
+export declare function getProjectRoot(): string;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAgB5E;AAED,wBAAgB,cAAc,IAAI,MAAM,CAQvC"}

package/dist/git.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findGitRoot = findGitRoot;
+exports.getProjectRoot = getProjectRoot;
+const fs_1 = require("fs");
+const path_1 = require("path");
+function findGitRoot(startPath = process.cwd()) {
+    let currentPath = startPath;
+    while (true) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(currentPath, '.git'))) {
+            return currentPath;
+        }
+        const parentPath = (0, path_1.join)(currentPath, '..');
+        if (parentPath === currentPath) {
+            // Reached root without finding .git
+            return null;
+        }
+        currentPath = parentPath;
+    }
+}
+function getProjectRoot() {
+    const gitRoot = findGitRoot();
+    if (gitRoot) {
+        return gitRoot;
+    }
+    // Fallback to current directory if not a git repo
+    return process.cwd();
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":";;AAIA,kCAgBC;AAED,wCAQC;AA7BD,2BAAgC;AAChC,+BAA4B;AAE5B,SAAgB,WAAW,CAAC,YAAoB,OAAO,CAAC,GAAG,EAAE;IAC3D,IAAI,WAAW,GAAG,SAAS,CAAC;IAE5B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC1C,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAC/B,oCAAoC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,WAAW,GAAG,UAAU,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kDAAkD;IAClD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const child_process_1 = require("child_process");
+const commands_1 = require("./commands");
+const git_1 = require("./git");
+const program = new commander_1.Command();
+program
+    .name('runbook')
+    .description('Remember project commands. Run them from anywhere.')
+    .version('1.0.0');
+// Set command
+program
+    .command('set')
+    .description('Set a command for this project')
+    .argument('<name>', 'Command name (e.g., dev, test, build)')
+    .argument('<command>', 'Command to run (e.g., "npm run dev")')
+    .action((name, command) => {
+    (0, commands_1.setCommand)(name, command);
+    console.log(chalk_1.default.green(`\n✓ Set '${name}' → ${command}`));
+    console.log(chalk_1.default.gray(`  Run with: runbook ${name}\n`));
+});
+// Delete command
+program
+    .command('delete')
+    .alias('rm')
+    .description('Delete a command')
+    .argument('<name>', 'Command name to delete')
+    .action((name) => {
+    if ((0, commands_1.deleteCommand)(name)) {
+        console.log(chalk_1.default.green(`\n✓ Deleted '${name}'\n`));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`\n⚠ Command '${name}' not found\n`));
+    }
+});
+// List commands
+program
+    .command('list')
+    .alias('ls')
+    .description('List all commands for this project')
+    .action(() => {
+    const commands = (0, commands_1.listCommands)();
+    const entries = Object.entries(commands);
+    if (entries.length === 0) {
+        console.log(chalk_1.default.yellow('\nNo commands set for this project.'));
+        console.log(chalk_1.default.gray('Set one with: runbook set <name> <command>\n'));
+        return;
+    }
+    console.log(chalk_1.default.bold.cyan(`\nCommands for ${(0, git_1.getProjectRoot)()}\n`));
+    const table = new cli_table3_1.default({
+        head: [chalk_1.default.cyan.bold('Name'), chalk_1.default.cyan.bold('Command')],
+        style: { head: [], border: [] },
+        colWidths: [15, 65],
+        wordWrap: true,
+    });
+    for (const [name, command] of entries) {
+        table.push([chalk_1.default.green(name), chalk_1.default.white(command)]);
+    }
+    console.log(table.toString());
+    console.log(chalk_1.default.gray(`\nRun with: runbook <name>`));
+    console.log(chalk_1.default.gray(`Stored in: ${(0, commands_1.getRunbookPath)()}\n`));
+});
+// Info command
+program
+    .command('info')
+    .description('Show project info')
+    .action(() => {
+    console.log(chalk_1.default.cyan('\nProject Info\n'));
+    console.log(chalk_1.default.white('Root: ') + chalk_1.default.gray((0, git_1.getProjectRoot)()));
+    console.log(chalk_1.default.white('Runbook: ') + chalk_1.default.gray((0, commands_1.getRunbookPath)()));
+    const commands = (0, commands_1.listCommands)();
+    console.log(chalk_1.default.white('Commands: ') + chalk_1.default.gray(Object.keys(commands).length.toString()));
+    console.log();
+});
+// Run command (default action)
+program
+    .argument('[name]', 'Command name to run')
+    .action((name) => {
+    if (!name) {
+        // Show list if no command specified
+        const commands = (0, commands_1.listCommands)();
+        const entries = Object.entries(commands);
+        if (entries.length === 0) {
+            console.log(chalk_1.default.yellow('\nNo commands set for this project.'));
+            console.log(chalk_1.default.gray('Set one with: runbook set <name> <command>\n'));
+            return;
+        }
+        console.log(chalk_1.default.bold.cyan('\nAvailable commands:\n'));
+        for (const [cmdName] of entries) {
+            console.log(chalk_1.default.green(`  runbook ${cmdName}`));
+        }
+        console.log();
+        return;
+    }
+    const command = (0, commands_1.getCommand)(name);
+    if (!command) {
+        console.log(chalk_1.default.red(`\n✗ Command '${name}' not found`));
+        console.log(chalk_1.default.gray('Set it with: runbook set ' + name + ' <command>\n'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.cyan(`\n→ Running: ${command}\n`));
+    // Run command in shell
+    const child = (0, child_process_1.spawn)(command, [], {
+        shell: true,
+        stdio: 'inherit',
+        cwd: (0, git_1.getProjectRoot)(),
+    });
+    child.on('exit', (code) => {
+        process.exit(code || 0);
+    });
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "runbook-cli",
+  "version": "1.0.0",
+  "description": "Remember project commands. Run them from anywhere.",
+  "main": "dist/index.js",
+  "bin": {
+    "runbook": "./dist/index.js",
+    "rb": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "commands",
+    "project",
+    "cli",
+    "dev",
+    "workflow",
+    "automation"
+  ],
+  "author": "Brian Mwirigi",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "cli-table3": "^0.6.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.6",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/commands.ts

@@ -0,0 +1,59 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { getProjectRoot } from './git';
+
+export interface RunbookCommands {
+  [key: string]: string;
+}
+
+const RUNBOOK_FILE = '.runbook';
+
+export function getRunbookPath(): string {
+  const projectRoot = getProjectRoot();
+  return join(projectRoot, RUNBOOK_FILE);
+}
+
+export function loadCommands(): RunbookCommands {
+  const runbookPath = getRunbookPath();
+  
+  if (!existsSync(runbookPath)) {
+    return {};
+  }
+  
+  try {
+    const content = readFileSync(runbookPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    return {};
+  }
+}
+
+export function saveCommands(commands: RunbookCommands): void {
+  const runbookPath = getRunbookPath();
+  writeFileSync(runbookPath, JSON.stringify(commands, null, 2), 'utf-8');
+}
+
+export function setCommand(name: string, command: string): void {
+  const commands = loadCommands();
+  commands[name] = command;
+  saveCommands(commands);
+}
+
+export function getCommand(name: string): string | undefined {
+  const commands = loadCommands();
+  return commands[name];
+}
+
+export function deleteCommand(name: string): boolean {
+  const commands = loadCommands();
+  if (!(name in commands)) {
+    return false;
+  }
+  delete commands[name];
+  saveCommands(commands);
+  return true;
+}
+
+export function listCommands(): RunbookCommands {
+  return loadCommands();
+}

package/src/git.ts

@@ -0,0 +1,31 @@
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+export function findGitRoot(startPath: string = process.cwd()): string | null {
+  let currentPath = startPath;
+  
+  while (true) {
+    if (existsSync(join(currentPath, '.git'))) {
+      return currentPath;
+    }
+    
+    const parentPath = join(currentPath, '..');
+    if (parentPath === currentPath) {
+      // Reached root without finding .git
+      return null;
+    }
+    
+    currentPath = parentPath;
+  }
+}
+
+export function getProjectRoot(): string {
+  const gitRoot = findGitRoot();
+  if (gitRoot) {
+    return gitRoot;
+  }
+  
+  // Fallback to current directory if not a git repo
+  return process.cwd();
+}

package/src/index.ts

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { spawn } from 'child_process';
+import { setCommand, getCommand, deleteCommand, listCommands, getRunbookPath } from './commands';
+import { getProjectRoot } from './git';
+
+const program = new Command();
+
+program
+  .name('runbook')
+  .description('Remember project commands. Run them from anywhere.')
+  .version('1.0.0');
+
+// Set command
+program
+  .command('set')
+  .description('Set a command for this project')
+  .argument('<name>', 'Command name (e.g., dev, test, build)')
+  .argument('<command>', 'Command to run (e.g., "npm run dev")')
+  .action((name: string, command: string) => {
+    setCommand(name, command);
+    console.log(chalk.green(`\n✓ Set '${name}' → ${command}`));
+    console.log(chalk.gray(`  Run with: runbook ${name}\n`));
+  });
+
+// Delete command
+program
+  .command('delete')
+  .alias('rm')
+  .description('Delete a command')
+  .argument('<name>', 'Command name to delete')
+  .action((name: string) => {
+    if (deleteCommand(name)) {
+      console.log(chalk.green(`\n✓ Deleted '${name}'\n`));
+    } else {
+      console.log(chalk.yellow(`\n⚠ Command '${name}' not found\n`));
+    }
+  });
+
+// List commands
+program
+  .command('list')
+  .alias('ls')
+  .description('List all commands for this project')
+  .action(() => {
+    const commands = listCommands();
+    const entries = Object.entries(commands);
+    
+    if (entries.length === 0) {
+      console.log(chalk.yellow('\nNo commands set for this project.'));
+      console.log(chalk.gray('Set one with: runbook set <name> <command>\n'));
+      return;
+    }
+    
+    console.log(chalk.bold.cyan(`\nCommands for ${getProjectRoot()}\n`));
+    
+    const table = new Table({
+      head: [chalk.cyan.bold('Name'), chalk.cyan.bold('Command')],
+      style: { head: [], border: [] },
+      colWidths: [15, 65],
+      wordWrap: true,
+    });
+    
+    for (const [name, command] of entries) {
+      table.push([chalk.green(name), chalk.white(command)]);
+    }
+    
+    console.log(table.toString());
+    console.log(chalk.gray(`\nRun with: runbook <name>`));
+    console.log(chalk.gray(`Stored in: ${getRunbookPath()}\n`));
+  });
+
+// Info command
+program
+  .command('info')
+  .description('Show project info')
+  .action(() => {
+    console.log(chalk.cyan('\nProject Info\n'));
+    console.log(chalk.white('Root: ') + chalk.gray(getProjectRoot()));
+    console.log(chalk.white('Runbook: ') + chalk.gray(getRunbookPath()));
+    
+    const commands = listCommands();
+    console.log(chalk.white('Commands: ') + chalk.gray(Object.keys(commands).length.toString()));
+    console.log();
+  });
+
+// Run command (default action)
+program
+  .argument('[name]', 'Command name to run')
+  .action((name?: string) => {
+    if (!name) {
+      // Show list if no command specified
+      const commands = listCommands();
+      const entries = Object.entries(commands);
+      
+      if (entries.length === 0) {
+        console.log(chalk.yellow('\nNo commands set for this project.'));
+        console.log(chalk.gray('Set one with: runbook set <name> <command>\n'));
+        return;
+      }
+      
+      console.log(chalk.bold.cyan('\nAvailable commands:\n'));
+      for (const [cmdName] of entries) {
+        console.log(chalk.green(`  runbook ${cmdName}`));
+      }
+      console.log();
+      return;
+    }
+    
+    const command = getCommand(name);
+    
+    if (!command) {
+      console.log(chalk.red(`\n✗ Command '${name}' not found`));
+      console.log(chalk.gray('Set it with: runbook set ' + name + ' <command>\n'));
+      process.exit(1);
+    }
+    
+    console.log(chalk.cyan(`\n→ Running: ${command}\n`));
+    
+    // Run command in shell
+    const child = spawn(command, [], {
+      shell: true,
+      stdio: 'inherit',
+      cwd: getProjectRoot(),
+    });
+    
+    child.on('exit', (code) => {
+      process.exit(code || 0);
+    });
+  });
+
+program.parse();

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}