quickclaude 1.0.8 → 1.1.0

package/.github/workflows/publish.yml

@@ -2,8 +2,8 @@ name: Publish to npm
 
 on:
   push:
-    tags:
-      - "v*"
+    branches:
+      - main
 
 jobs:
   publish:
@@ -12,11 +12,14 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 22
+          registry-url: https://registry.npmjs.org
       - run: npm install -g npm@latest
       - run: npm --version
       - run: npm ci
       - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CLAUDE.md

@@ -0,0 +1,27 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+quickclaude is a CLI launcher for Claude Code. It scans `~/.claude/projects/` for project directories, presents an interactive selection menu, and spawns `claude` in the chosen directory.
+
+## Commands
+
+- **Run**: `node bin/quickclaude.js` or `npm start`
+- **Install globally (for testing)**: `npm install -g .`
+- **No build step or test suite** — this is a single-file Node.js CLI tool
+
+## Architecture
+
+The entire tool lives in `bin/quickclaude.js` (ESM, `#!/usr/bin/env node`):
+
+- **`resolvePath(encoded)`** — Converts Claude's encoded project directory names (e.g., `-Users-dongwoo-projects-my-app`) back to real filesystem paths. Uses greedy longest-match against the filesystem, trying both `-` and space as segment joiners. Handles Windows drive letters (`C--Users-...`).
+- **`getProjects()`** — Reads `~/.claude/projects/`, resolves each subdirectory name via `resolvePath`, filters out worktree dirs and non-existent paths.
+- **`main()`** — Uses `@clack/prompts` for the interactive select UI, then spawns `claude` with `stdio: "inherit"` in the selected directory.
+
+## Key Details
+
+- Single dependency: `@clack/prompts` for terminal UI
+- Published to npm as `quickclaude` (global install / npx)
+- Requires Node.js 18+ and Claude Code installed

package/README.md

@@ -29,6 +29,11 @@ Or run without installing:
 npx quickclaude
 ```
 
+## Update
+```bash
+npm update -g quickclaude
+```
+
 ## How it works
 
 1. Scans `~/.claude/projects/` for Claude Code project directories

package/bin/quickclaude.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import * as p from "@clack/prompts";
-import { readdirSync, existsSync } from "fs";
+import { readdirSync, existsSync, statSync } from "fs";
 import { join, sep } from "path";
 import { homedir } from "os";
 import { execSync, spawn } from "child_process";
@@ -68,13 +68,33 @@ function getProjects() {
       if (p.path.includes(`claude${sep}worktrees`)) return false;
       return existsSync(p.path);
     })
-    .sort((a, b) => a.path.localeCompare(b.path));
+    .map((p) => {
+      const projectDir = join(CLAUDE_PROJECTS_DIR, p.dirName);
+      const mtime = statSync(projectDir).mtimeMs;
+      return { ...p, mtime };
+    })
+    .sort((a, b) => b.mtime - a.mtime);
+}
+
+function timeAgo(mtimeMs) {
+  const seconds = Math.floor((Date.now() - mtimeMs) / 1000);
+  if (seconds < 60) return "just now";
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  const weeks = Math.floor(days / 7);
+  if (weeks < 4) return `${weeks}w ago`;
+  const months = Math.floor(days / 30);
+  return `${months}mo ago`;
 }
 
-function getProjectLabel(path) {
+function getProjectLabel(path, mtimeMs) {
   const home = homedir();
   const display = path.startsWith(home) ? "~" + path.slice(home.length) : path;
-  return display;
+  return `${timeAgo(mtimeMs)} · ${display}`;
 }
 
 async function main() {
@@ -91,7 +111,7 @@ async function main() {
     message: "Select a project",
     options: projects.map((proj) => ({
       value: proj.path,
-      label: getProjectLabel(proj.path),
+      label: getProjectLabel(proj.path, proj.mtime),
     })),
   });
 
@@ -100,10 +120,12 @@ async function main() {
     process.exit(0);
   }
 
+  const args = process.argv.slice(2);
+
   p.outro(`Launching Claude in ${selected}`);
 
   // claude 실행 (현재 터미널에서 interactive하게)
-  const child = spawn("claude", [], {
+  const child = spawn("claude", args, {
     cwd: selected,
     stdio: "inherit",
     shell: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickclaude",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "Quickly launch Claude Code in your project directories",
   "type": "module",
   "bin": {