@getjack/jack 0.1.2 → 0.1.4

package/README.md

@@ -1,14 +1,57 @@
-# jack
+<p align="center">
+  <h1 align="center">jack</h1>
+  <p align="center"><strong>Ship before you forget why you started.</strong></p>
+</p>
 
-CLI for vibecoders to rapidly deploy to Cloudflare Workers.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@getjack/jack"><img src="https://img.shields.io/npm/v/@getjack/jack" alt="npm"></a>
+  <a href="https://github.com/getjack-org/jack/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="license"></a>
+  <a href="https://docs.getjack.org"><img src="https://img.shields.io/badge/docs-getjack.org-green" alt="docs"></a>
+  <a href="https://discord.gg/fb64krv48R"><img src="https://img.shields.io/badge/discord-community-5865F2" alt="discord"></a>
+</p>
 
-## Install
+---
+
+<p align="center">
+  <img src="https://docs.getjack.org/jack-demo.gif" alt="jack demo" width="600">
+</p>
+
+---
+
+You're vibecoding. Ideas are flowing. You want to ship.
+
+But first: config files, deployment setup, secret management, debugging infrastructure errors...
+
+**30 minutes later, the spark is gone.**
+
+jack removes the friction between your idea and a live URL.
 
 ```bash
-# Install Bun (if needed)
-curl -fsSL https://bun.sh/install | bash
+bunx @getjack/jack new my-app   # → deployed. live. done.
+```
+
+That's it. Write code. Ship again with `jack ship`. Stay in flow.
+
+---
+
+## Why jack
+
+**Instant deployment** — `jack new` creates AND deploys. You have a live URL before your first commit.
+
+**Works with your agent** — Claude Code, Cursor, Codex, whatever. Every project includes AI context files so your agent understands the stack from prompt one.
+
+**Roaming secrets** — Configure once, use across all projects. No more per-project secret ceremony.
+
+**Project tracking** — 100 experiments scattered everywhere? `jack ls` finds them all.
 
-# Run directly
+**No lock-in** — Standard config files, standard TypeScript. Your projects work without jack installed.
+
+---
+
+## Quick Start
+
+```bash
+# One command to create and deploy
 bunx @getjack/jack new my-app
 
 # Or install globally
@@ -16,40 +59,45 @@ bun add -g @getjack/jack
 jack new my-app
 ```
 
-## Usage
+You'll need [Bun](https://bun.sh) and a Cloudflare account (free tier works).
 
-```bash
-# Create a new project
-jack new my-app
+---
 
-# Deploy to Cloudflare Workers
-jack ship
+## Commands
 
-# List your projects
-jack list
-```
+| Command | What it does |
+|---------|--------------|
+| `jack new <name>` | Create and deploy a new project |
+| `jack ship` | Deploy current project |
+| `jack ls` | Show all your projects |
+| `jack open` | Open project in browser |
+| `jack secrets` | Manage project secrets |
+| `jack feedback` | Share feedback or report issues |
 
-## Requirements
+Full documentation at **[docs.getjack.org](https://docs.getjack.org)**
 
-- [Bun](https://bun.sh) >= 1.0.0
-- Cloudflare account (for deployments)
+---
 
-## Releasing
+## Who This Is For
 
-This project uses [Semantic Versioning](https://semver.org/).
+Builders who ship constantly. You spin up new projects all the time, and suddenly you have dozens scattered across your machine—each with its own env vars, secrets, and deploy setup you've already forgotten.
 
-```bash
-# Bump version, commit, and tag
-npm version patch   # 0.1.1 → 0.1.2 (bug fixes)
-npm version minor   # 0.1.1 → 0.2.0 (new features)
-npm version major   # 0.1.1 → 1.0.0 (breaking changes)
+jack keeps you organized. One command to ship, one place to find everything, zero setup overhead. Stay creative, skip the ceremony.
 
-# Push to trigger publish
-git push && git push --tags
-```
+---
+
+## Philosophy
 
-GitHub Actions automatically publishes to npm when a version tag is pushed.
+In Gibson's *Neuromancer*, "jacking in" means plugging directly into cyberspace. The body becomes irrelevant—you're pure thought in the matrix.
+
+jack handles the infrastructure so you stay in creative flow. The boring parts disappear. You just build.
+
+---
 
 ## License
 
 Apache-2.0
+
+<p align="center">
+  <i>Every deployment friction point is a creative thought lost.</i>
+</p>

package/package.json

@@ -1,49 +1,56 @@
 {
-  "name": "@getjack/jack",
-  "version": "0.1.2",
-  "description": "CLI for vibecoders to rapidly deploy to Cloudflare Workers",
-  "license": "Apache-2.0",
-  "type": "module",
-  "bin": {
-    "jack": "./src/index.ts"
-  },
-  "files": [
-    "src",
-    "templates"
-  ],
-  "engines": {
-    "bun": ">=1.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/getjack-org/jack"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "cli",
-    "cloudflare",
-    "workers",
-    "deploy",
-    "vibecode"
-  ],
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build --compile src/index.ts --outfile dist/jack",
-    "lint": "biome check .",
-    "format": "biome format --write ."
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.9.0",
-    "bun-types": "latest"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^7.0.0",
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "meow": "^14.0.0",
-    "posthog-node": "^5.17.4",
-    "yocto-spinner": "^1.0.0",
-    "zod": "^4.2.1"
-  }
+	"name": "@getjack/jack",
+	"version": "0.1.4",
+	"description": "Ship before you forget why you started. The vibecoder's deployment CLI.",
+	"license": "Apache-2.0",
+	"type": "module",
+	"bin": {
+		"jack": "./src/index.ts"
+	},
+	"files": [
+		"src",
+		"templates"
+	],
+	"engines": {
+		"bun": ">=1.0.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/getjack-org/jack"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"cli",
+		"deploy",
+		"vibecoding",
+		"vibecode",
+		"shipping",
+		"edge",
+		"serverless",
+		"ai-agent",
+		"claude",
+		"cursor"
+	],
+	"scripts": {
+		"dev": "bun run src/index.ts",
+		"build": "bun build --compile src/index.ts --outfile dist/jack",
+		"lint": "biome check .",
+		"format": "biome format --write ."
+	},
+	"devDependencies": {
+		"@types/archiver": "^7.0.0",
+		"bun-types": "latest"
+	},
+	"dependencies": {
+		"@inquirer/prompts": "^7.0.0",
+		"@modelcontextprotocol/sdk": "^1.25.1",
+		"archiver": "^7.0.1",
+		"human-id": "^4.1.3",
+		"meow": "^14.0.0",
+		"posthog-node": "^5.17.4",
+		"yocto-spinner": "^1.0.0",
+		"zod": "^4.2.1"
+	}
 }

package/src/commands/agents.ts

@@ -1,8 +1,12 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { regenerateAgentFiles } from "../lib/agent-files.ts";
 import {
 	AGENT_REGISTRY,
 	addAgent,
 	disableAgent,
 	enableAgent,
+	getActiveAgents,
 	getAgentDefinition,
 	getPreferredAgent,
 	pathExists,
@@ -12,12 +16,24 @@ import {
 	updateAgent,
 } from "../lib/agents.ts";
 import { readConfig } from "../lib/config.ts";
-import { error, info, item, output as outputSpinner, success } from "../lib/output.ts";
+import { error, info, item, output as outputSpinner, success, warn } from "../lib/output.ts";
+import { getProject } from "../lib/registry.ts";
+import { getProjectNameFromDir } from "../lib/storage/index.ts";
+import { resolveTemplate } from "../templates/index.ts";
+import type { Template } from "../templates/types.ts";
 
 /**
  * Main agents command - handles all agent management
  */
-export default async function agents(subcommand?: string, args: string[] = []): Promise<void> {
+interface AgentsOptions {
+	project?: string;
+}
+
+export default async function agents(
+	subcommand?: string,
+	args: string[] = [],
+	options: AgentsOptions = {},
+): Promise<void> {
 	if (!subcommand) {
 		return await listAgents();
 	}
@@ -35,9 +51,11 @@ export default async function agents(subcommand?: string, args: string[] = []):
 			return await disableAgentCommand(args);
 		case "prefer":
 			return await preferAgentCommand(args);
+		case "refresh":
+			return await refreshAgentFilesCommand(options);
 		default:
 			error(`Unknown subcommand: ${subcommand}`);
-			info("Available: scan, add, remove, enable, disable, prefer");
+			info("Available: scan, add, remove, enable, disable, prefer, refresh");
 			process.exit(1);
 	}
 }
@@ -76,7 +94,7 @@ async function listAgents(): Promise<void> {
 		console.error("");
 	}
 
-	info("Commands: jack agents scan | add | remove | enable | disable | prefer");
+	info("Commands: jack agents scan | add | remove | enable | disable | prefer | refresh");
 }
 
 /**
@@ -89,6 +107,7 @@ async function scanAndPrompt(): Promise<void> {
 
 	if (detectionResult.detected.length === 0) {
 		info("No agents detected");
+		await listAgents();
 		return;
 	}
 
@@ -98,6 +117,7 @@ async function scanAndPrompt(): Promise<void> {
 
 	if (newAgents.length === 0) {
 		success("No new agents found");
+		await listAgents();
 		return;
 	}
 
@@ -119,13 +139,16 @@ async function scanAndPrompt(): Promise<void> {
 	console.error("");
 	success("New agents enabled");
 	info("Future projects will include context files for these agents");
+	await listAgents();
 }
 
 function getFlagValues(args: string[], flag: string): string[] {
 	const values: string[] = [];
 	for (let i = 0; i < args.length; i++) {
-		if (args[i] === flag && args[i + 1]) {
-			values.push(args[i + 1]);
+		const current = args[i];
+		const next = args[i + 1];
+		if (current === flag && next) {
+			values.push(next);
 			i++;
 		}
 	}
@@ -174,7 +197,7 @@ async function addAgentCommand(args: string[]): Promise<void> {
 					type: "cli" as const,
 					command: customCommand,
 					args: customArgs.length ? customArgs : undefined,
-			  }
+				}
 			: undefined;
 
 		await addAgent(agentId, { launch: launchOverride });
@@ -190,9 +213,7 @@ async function addAgentCommand(args: string[]): Promise<void> {
 		if (err instanceof Error) {
 			error(err.message);
 			if (err.message.includes("Could not detect")) {
-				info(
-					`Specify launch manually: jack agents add ${agentId} --command /path/to/command`,
-				);
+				info(`Specify launch manually: jack agents add ${agentId} --command /path/to/command`);
 			}
 		}
 		process.exit(1);
@@ -303,3 +324,117 @@ async function preferAgentCommand(args: string[]): Promise<void> {
 		process.exit(1);
 	}
 }
+
+/**
+ * Refresh agent context files from template
+ */
+async function refreshAgentFilesCommand(options: AgentsOptions = {}): Promise<void> {
+	const projectDir = process.cwd();
+	let projectName: string;
+	let project = null;
+
+	if (options.project) {
+		// When --project is specified, we still need to run from that project's directory
+		// since localPath is no longer stored in the registry
+		projectName = options.project;
+		project = await getProject(projectName);
+
+		if (!project) {
+			error(`Project "${projectName}" not found in registry`);
+			info("List projects with: jack projects list");
+			process.exit(1);
+		}
+
+		// Verify the current directory matches the project
+		try {
+			const cwdProjectName = await getProjectNameFromDir(projectDir);
+			if (cwdProjectName !== projectName) {
+				error(`Current directory is not the project "${projectName}"`);
+				info(`Run this command from the ${projectName} project directory`);
+				process.exit(1);
+			}
+		} catch {
+			error(`Current directory is not a valid project`);
+			info(`Run this command from the ${projectName} project directory`);
+			process.exit(1);
+		}
+	} else {
+		// 1. Detect project name from wrangler config
+		outputSpinner.start("Detecting project...");
+		try {
+			projectName = await getProjectNameFromDir(projectDir);
+		} catch {
+			outputSpinner.stop();
+			error("Could not determine project");
+			info("Run this command from a project directory, or use --project <name>");
+			process.exit(1);
+		}
+		outputSpinner.stop();
+
+		// 2. Get project from registry to find template origin
+		project = await getProject(projectName);
+		if (!project) {
+			error(`Project "${projectName}" not found in registry`);
+			info("List projects with: jack projects list");
+			process.exit(1);
+		}
+	}
+
+	if (!project?.template) {
+		error("No template lineage found for this project");
+		info("This project was created before lineage tracking was added.");
+		info("Re-create the project with `jack new` to enable refresh.");
+		process.exit(1);
+	}
+
+	// 3. Resolve template (fetch if GitHub, load if builtin)
+	outputSpinner.start("Loading template...");
+	let template: Template;
+	try {
+		template = await resolveTemplate(project.template.name);
+	} catch (err) {
+		outputSpinner.stop();
+		error(`Failed to load template: ${project.template.name}`);
+		if (err instanceof Error) {
+			info(err.message);
+		}
+		process.exit(1);
+	}
+	outputSpinner.stop();
+
+	// 4. Backup existing files
+	const agentsMdPath = join(projectDir, "AGENTS.md");
+	if (existsSync(agentsMdPath)) {
+		const backupPath = `${agentsMdPath}.backup`;
+		const content = await Bun.file(agentsMdPath).text();
+		await Bun.write(backupPath, content);
+		success("Backed up AGENTS.md → AGENTS.md.backup");
+	}
+
+	const claudeMdPath = join(projectDir, "CLAUDE.md");
+	if (existsSync(claudeMdPath)) {
+		const backupPath = `${claudeMdPath}.backup`;
+		const content = await Bun.file(claudeMdPath).text();
+		await Bun.write(backupPath, content);
+		success("Backed up CLAUDE.md → CLAUDE.md.backup");
+	}
+
+	// 5. Get active agents
+	const activeAgents = await getActiveAgents();
+	if (activeAgents.length === 0) {
+		warn("No active agents configured");
+		info("Run: jack agents scan");
+		process.exit(1);
+	}
+
+	// 6. Regenerate agent files
+	const updatedFiles = await regenerateAgentFiles(projectDir, projectName, template, activeAgents);
+
+	console.error("");
+	success("Refreshed agent context files:");
+	for (const file of updatedFiles) {
+		item(file);
+	}
+	console.error("");
+	info("Review changes: git diff AGENTS.md");
+}