quickclaude 1.0.0 → 1.0.7

package/.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm install -g npm@latest
+      - run: npm --version
+      - run: npm ci
+      - run: npm publish --provenance --access public

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seunghyun Hong
+
+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,45 @@
+# quickclaude
+
+CLI launcher for Claude Code.
+Quickly launch Claude Code in your project directories.
+<img width="762" height="383" alt="Screenshot 2026-03-28 at 6 25 10 PM" src="https://github.com/user-attachments/assets/4f368300-9748-4190-87c1-f2a1fcfd8a63" />
+
+
+```
+$ quickclaude
+
+┌  quickclaude
+│
+◆  Select a project
+│  ● ~/Documents/projects/my-app1
+│  ○ ~/Documents/projects/my-app2
+│  ○ ~/Documents/projects/my-app3
+└
+```
+
+## Install
+
+```bash
+npm install -g quickclaude
+```
+
+Or run without installing:
+
+```bash
+npx quickclaude
+```
+
+## How it works
+
+1. Scans `~/.claude/projects/` for Claude Code project directories
+2. Shows an interactive list to pick from
+3. Launches `claude` in the selected directory
+
+## Requirements
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
+- Node.js 18+
+
+## License
+
+MIT

package/bin/quickclaude.js

@@ -15,8 +15,16 @@ const CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
 function resolvePath(encoded) {
   const parts = encoded.replace(/^-/, "").split("-");
   let current = sep;
-
   let i = 0;
+
+  // Windows: "C--Users-..." → drive letter "C:" 처리
+  if (parts.length >= 1 && /^[A-Za-z]$/.test(parts[0])) {
+    const drive = parts[0].toUpperCase() + ":\\";
+    if (existsSync(drive)) {
+      current = drive;
+      i = 1;
+    }
+  }
   while (i < parts.length) {
     let matched = false;
     // 긴 조합부터 시도 (mcp-overwatch, Unreal Projects 등)
@@ -75,12 +83,12 @@ async function main() {
   const projects = getProjects();
 
   if (projects.length === 0) {
-    p.cancel("Claude 프로젝트를 찾을 수 없습니다.");
+    p.cancel("No Claude projects found.");
     process.exit(1);
   }
 
   const selected = await p.select({
-    message: "프로젝트를 선택하세요",
+    message: "Select a project",
     options: projects.map((proj) => ({
       value: proj.path,
       label: getProjectLabel(proj.path),
@@ -88,11 +96,11 @@ async function main() {
   });
 
   if (p.isCancel(selected)) {
-    p.cancel("취소됨");
+    p.cancel("Cancelled");
     process.exit(0);
   }
 
-  p.outro(`${selected} 에서 Claude 시작...`);
+  p.outro(`Launching Claude in ${selected}`);
 
   // claude 실행 (현재 터미널에서 interactive하게)
   const child = spawn("claude", [], {

package/package.json

@@ -1,19 +1,23 @@
 {
   "name": "quickclaude",
-  "version": "1.0.0",
+  "version": "1.0.7",
   "description": "Quickly launch Claude Code in your project directories",
   "type": "module",
   "bin": {
     "quickclaude": "bin/quickclaude.js"
   },
   "scripts": {
-    "start": "node src/index.js"
+    "start": "node bin/quickclaude.js"
   },
   "keywords": [
     "claude",
     "cli",
     "launcher"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/strurao/quickclaude"
+  },
   "author": "",
   "license": "MIT",
   "dependencies": {

package/src/index.js

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-
-import * as p from "@clack/prompts";
-import { readdirSync, existsSync } from "fs";
-import { join, sep } from "path";
-import { homedir } from "os";
-import { execSync, spawn } from "child_process";
-
-const CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
-
-// 인코딩된 디렉토리명에서 실제 경로를 복원
-// "-Users-seunghyunhong-Documents-projects-mcp-overwatch" 같은 경우
-// -를 /로 바꾸면 mcp/overwatch가 되어 틀려짐
-// → 파일시스템을 실제로 탐색하며 매칭
-function resolvePath(encoded) {
-  const parts = encoded.replace(/^-/, "").split("-");
-  let current = sep;
-
-  let i = 0;
-  while (i < parts.length) {
-    let matched = false;
-    // 긴 조합부터 시도 (mcp-overwatch, Unreal Projects 등)
-    for (let len = parts.length - i; len >= 1; len--) {
-      const segment = parts.slice(i, i + len);
-      // "-"와 " " 두 가지 구분자 조합을 모두 시도
-      const separators = ["-", " "];
-      for (const joiner of separators) {
-        const candidate = segment.join(joiner);
-        const fullPath = join(current, candidate);
-        if (existsSync(fullPath)) {
-          current = fullPath;
-          i += len;
-          matched = true;
-          break;
-        }
-      }
-      if (matched) break;
-    }
-    if (!matched) return null;
-  }
-
-  return current;
-}
-
-function getProjects() {
-  if (!existsSync(CLAUDE_PROJECTS_DIR)) {
-    return [];
-  }
-
-  const entries = readdirSync(CLAUDE_PROJECTS_DIR, { withFileTypes: true });
-
-  return entries
-    .filter((e) => e.isDirectory())
-    .map((e) => {
-      const path = resolvePath(e.name);
-      return { dirName: e.name, path };
-    })
-    .filter((p) => {
-      if (!p.path) return false;
-      if (p.path.includes(`claude${sep}worktrees`)) return false;
-      return existsSync(p.path);
-    })
-    .sort((a, b) => a.path.localeCompare(b.path));
-}
-
-function getProjectLabel(path) {
-  const home = homedir();
-  const display = path.startsWith(home) ? "~" + path.slice(home.length) : path;
-  return display;
-}
-
-async function main() {
-  p.intro("quickclaude");
-
-  const projects = getProjects();
-
-  if (projects.length === 0) {
-    p.cancel("Claude 프로젝트를 찾을 수 없습니다.");
-    process.exit(1);
-  }
-
-  const selected = await p.select({
-    message: "프로젝트를 선택하세요",
-    options: projects.map((proj) => ({
-      value: proj.path,
-      label: getProjectLabel(proj.path),
-    })),
-  });
-
-  if (p.isCancel(selected)) {
-    p.cancel("취소됨");
-    process.exit(0);
-  }
-
-  p.outro(`${selected} 에서 Claude 시작...`);
-
-  // claude 실행 (현재 터미널에서 interactive하게)
-  const child = spawn("claude", [], {
-    cwd: selected,
-    stdio: "inherit",
-    shell: true,
-  });
-
-  child.on("exit", (code) => {
-    process.exit(code ?? 0);
-  });
-}
-
-main();