ccdock 0.1.0__tar.gz

ccdock-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pashidl-lab
+
+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.

ccdock-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: ccdock
+Version: 0.1.0
+Summary: Pick a Claude Code project and its conda/venv environment from a local dashboard, and launch it in a new Windows Terminal tab or window
+Author-email: pashidl-lab <pashidl.lab@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/pashidl-lab/ccdock
+Project-URL: Issues, https://github.com/pashidl-lab/ccdock/issues
+Keywords: claude-code,conda,venv,launcher,dashboard,windows-terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# ccdock
+
+Claude Code로 작업하던 프로젝트와 conda 가상환경을 **한 화면에서 골라 바로 띄우는** 로컬 대시보드입니다.
+PC를 재부팅할 때마다 폴더 경로를 더듬고 가상환경 이름을 기억해내는 과정을 없애기 위해 만들었습니다.
+
+- 최근 작업순 프로젝트 목록 — Claude Code 사용 기록에서 자동 수집
+- **conda 환경과 프로젝트 폴더의 venv를 모두 인식** (`.venv`, `mvkit-env` 같은 폴더)
+- 각 가상환경의 **디스크 사용량 표시** — 배경에서 재고 캐시해 다음부터는 즉시 표시
+- 프로젝트별 가상환경을 한 번 지정하면 계속 기억
+- 선택 즉시 **Anaconda 프롬프트 새 탭 또는 새 창**이 열리고 환경이 활성화된 상태로 대기
+- 창이 여러 개 열려 있으면 **어느 창에 탭을 추가할지 선택**
+- 워크스페이스 — 자주 쓰는 3~5개 조합을 저장해두고 부팅 후 한 번에 복원
+- 외부 의존성 0 (표준 라이브러리만), 브라우저에서 뜨는 가벼운 대시보드
+
+## 설치
+
+```bat
+pip install ccdock
+```
+
+로컬 소스에서 바로 쓰려면:
+
+```bat
+pip install -e G:\path\to\ccdock
+```
+
+> conda `base` 환경에 설치하면 어떤 Anaconda 프롬프트에서도 `ccdock`를 바로 호출할 수 있습니다.
+
+## 사용
+
+```bat
+ccdock                    :: 대시보드를 열고 브라우저 실행
+ccdock -p 9000            :: 다른 포트로
+ccdock -n                 :: 브라우저를 열지 않음
+ccdock list               :: 프로젝트 목록을 터미널에 출력
+ccdock workspace 오전작업  :: 저장된 워크스페이스를 한 번에 실행
+```
+
+### 대시보드
+
+| 조작 | 설명 |
+| --- | --- |
+| `/` | 검색창으로 이동 |
+| 검색 후 `Enter` | 첫 번째 결과 실행 |
+| ☆ | 프로젝트 고정 (목록 맨 위로) |
+| 환경 드롭다운 | 가상환경 지정 — 즉시 저장됨 |
+| `+ 담기` → `워크스페이스 저장` | 여러 프로젝트를 하나의 조합으로 저장 |
+| `실행` | 터미널(새 탭/새 창)과 실행할 명령을 고르고 실행 |
+
+실행 모달에서 고르는 항목:
+
+- **가상환경** — conda 환경과 venv가 그룹으로 나뉘어 표시됩니다. 프로젝트 폴더 안에 venv가
+  있거나 `environment.yml` / `.ccdock-env`가 있으면 후보로 먼저 제안합니다
+- **터미널** — *기존 창에 새 탭* (열린 Windows Terminal 창이 있을 때) / *새 창으로 열기*
+- **어느 창에 탭을 추가할까요?** — 창이 2개 이상이면 창 제목으로 골라서 지정합니다
+- **실행할 명령** — `claude` / `claude --continue` / `claude --resume` / 프롬프트만
+
+### 가상환경 인식 범위
+
+| 종류 | 인식 방법 | 활성화 |
+| --- | --- | --- |
+| conda | `~/.conda/environments.txt` | `activate.bat <이름>` |
+| venv | 프로젝트 폴더와 그 상위 폴더 바로 아래의 `pyvenv.cfg` 보유 폴더 | `<경로>\Scripts\activate.bat` |
+
+프로젝트 폴더 안에 만들어 둔 `.venv`, `mvkit-env` 같은 가상환경이 자동으로 목록에 올라옵니다.
+
+### 디스크 사용량
+
+목록의 각 환경에 `claude312 — 792.4 MB` 처럼 크기가 함께 표시됩니다. 환경 하나를 훑는 데
+0.4~1초가 걸리므로 화면을 막지 않고 배경 스레드가 순서대로 재며, 결과는 `~/.ccdock/sizes.json`에
+남아 다음 실행부터는 즉시 나옵니다(7일 후 자동 재측정). 헤더의 합계 배지를 누르면 다시 잽니다.
+
+`base`는 `envs/`와 `pkgs/`를 빼고 계산합니다. 그러지 않으면 다른 환경과 패키지 캐시가
+전부 포함돼 실제보다 훨씬 크게 나옵니다.
+
+## 동작 방식
+
+| 정보 | 출처 |
+| --- | --- |
+| 프로젝트 경로 | `~/.claude.json` 의 `projects` 키 |
+| 마지막 작업 시각 | `~/.claude/projects/<슬러그>/*.jsonl` 파일 mtime |
+| 가상환경 목록 | `~/.conda/environments.txt` (없으면 conda 설치 폴더 스캔) |
+| 사용자 설정 | `~/.ccdock/config.json` |
+
+실행 시 임시 배치 파일을 만들어 `wt -w 0 new-tab`(새 탭) 또는 `wt -w new`(새 창)로 띄웁니다.
+`wt -w 0`은 "가장 최근에 사용한 창"을 뜻하므로, 특정 창을 지정하면 Win32 API로 그 창을 먼저
+앞으로 가져온 뒤 탭을 붙입니다. Windows Terminal이 없으면 `start cmd`로 대체합니다. 새 창에는 부모 프로세스의
+`VIRTUAL_ENV` / `CONDA_PREFIX` 흔적을 제거한 깨끗한 환경이 전달되므로, ccdock 자체를
+어떤 가상환경에서 실행하든 선택한 환경이 정확히 활성화됩니다.
+
+## 보안
+
+서버는 `127.0.0.1`에만 바인딩되며, 모든 API는 실행할 때마다 새로 만들어지는 토큰을 요구합니다.
+브라우저는 토큰이 포함된 URL로 자동으로 열립니다.
+
+## 요구 사항
+
+- Windows (Windows Terminal이 있으면 탭 기능 사용 가능)
+- Python 3.8+
+- Anaconda 또는 Miniconda
+
+## 라이선스
+
+MIT

ccdock-0.1.0/README.md

@@ -0,0 +1,104 @@
+# ccdock
+
+Claude Code로 작업하던 프로젝트와 conda 가상환경을 **한 화면에서 골라 바로 띄우는** 로컬 대시보드입니다.
+PC를 재부팅할 때마다 폴더 경로를 더듬고 가상환경 이름을 기억해내는 과정을 없애기 위해 만들었습니다.
+
+- 최근 작업순 프로젝트 목록 — Claude Code 사용 기록에서 자동 수집
+- **conda 환경과 프로젝트 폴더의 venv를 모두 인식** (`.venv`, `mvkit-env` 같은 폴더)
+- 각 가상환경의 **디스크 사용량 표시** — 배경에서 재고 캐시해 다음부터는 즉시 표시
+- 프로젝트별 가상환경을 한 번 지정하면 계속 기억
+- 선택 즉시 **Anaconda 프롬프트 새 탭 또는 새 창**이 열리고 환경이 활성화된 상태로 대기
+- 창이 여러 개 열려 있으면 **어느 창에 탭을 추가할지 선택**
+- 워크스페이스 — 자주 쓰는 3~5개 조합을 저장해두고 부팅 후 한 번에 복원
+- 외부 의존성 0 (표준 라이브러리만), 브라우저에서 뜨는 가벼운 대시보드
+
+## 설치
+
+```bat
+pip install ccdock
+```
+
+로컬 소스에서 바로 쓰려면:
+
+```bat
+pip install -e G:\path\to\ccdock
+```
+
+> conda `base` 환경에 설치하면 어떤 Anaconda 프롬프트에서도 `ccdock`를 바로 호출할 수 있습니다.
+
+## 사용
+
+```bat
+ccdock                    :: 대시보드를 열고 브라우저 실행
+ccdock -p 9000            :: 다른 포트로
+ccdock -n                 :: 브라우저를 열지 않음
+ccdock list               :: 프로젝트 목록을 터미널에 출력
+ccdock workspace 오전작업  :: 저장된 워크스페이스를 한 번에 실행
+```
+
+### 대시보드
+
+| 조작 | 설명 |
+| --- | --- |
+| `/` | 검색창으로 이동 |
+| 검색 후 `Enter` | 첫 번째 결과 실행 |
+| ☆ | 프로젝트 고정 (목록 맨 위로) |
+| 환경 드롭다운 | 가상환경 지정 — 즉시 저장됨 |
+| `+ 담기` → `워크스페이스 저장` | 여러 프로젝트를 하나의 조합으로 저장 |
+| `실행` | 터미널(새 탭/새 창)과 실행할 명령을 고르고 실행 |
+
+실행 모달에서 고르는 항목:
+
+- **가상환경** — conda 환경과 venv가 그룹으로 나뉘어 표시됩니다. 프로젝트 폴더 안에 venv가
+  있거나 `environment.yml` / `.ccdock-env`가 있으면 후보로 먼저 제안합니다
+- **터미널** — *기존 창에 새 탭* (열린 Windows Terminal 창이 있을 때) / *새 창으로 열기*
+- **어느 창에 탭을 추가할까요?** — 창이 2개 이상이면 창 제목으로 골라서 지정합니다
+- **실행할 명령** — `claude` / `claude --continue` / `claude --resume` / 프롬프트만
+
+### 가상환경 인식 범위
+
+| 종류 | 인식 방법 | 활성화 |
+| --- | --- | --- |
+| conda | `~/.conda/environments.txt` | `activate.bat <이름>` |
+| venv | 프로젝트 폴더와 그 상위 폴더 바로 아래의 `pyvenv.cfg` 보유 폴더 | `<경로>\Scripts\activate.bat` |
+
+프로젝트 폴더 안에 만들어 둔 `.venv`, `mvkit-env` 같은 가상환경이 자동으로 목록에 올라옵니다.
+
+### 디스크 사용량
+
+목록의 각 환경에 `claude312 — 792.4 MB` 처럼 크기가 함께 표시됩니다. 환경 하나를 훑는 데
+0.4~1초가 걸리므로 화면을 막지 않고 배경 스레드가 순서대로 재며, 결과는 `~/.ccdock/sizes.json`에
+남아 다음 실행부터는 즉시 나옵니다(7일 후 자동 재측정). 헤더의 합계 배지를 누르면 다시 잽니다.
+
+`base`는 `envs/`와 `pkgs/`를 빼고 계산합니다. 그러지 않으면 다른 환경과 패키지 캐시가
+전부 포함돼 실제보다 훨씬 크게 나옵니다.
+
+## 동작 방식
+
+| 정보 | 출처 |
+| --- | --- |
+| 프로젝트 경로 | `~/.claude.json` 의 `projects` 키 |
+| 마지막 작업 시각 | `~/.claude/projects/<슬러그>/*.jsonl` 파일 mtime |
+| 가상환경 목록 | `~/.conda/environments.txt` (없으면 conda 설치 폴더 스캔) |
+| 사용자 설정 | `~/.ccdock/config.json` |
+
+실행 시 임시 배치 파일을 만들어 `wt -w 0 new-tab`(새 탭) 또는 `wt -w new`(새 창)로 띄웁니다.
+`wt -w 0`은 "가장 최근에 사용한 창"을 뜻하므로, 특정 창을 지정하면 Win32 API로 그 창을 먼저
+앞으로 가져온 뒤 탭을 붙입니다. Windows Terminal이 없으면 `start cmd`로 대체합니다. 새 창에는 부모 프로세스의
+`VIRTUAL_ENV` / `CONDA_PREFIX` 흔적을 제거한 깨끗한 환경이 전달되므로, ccdock 자체를
+어떤 가상환경에서 실행하든 선택한 환경이 정확히 활성화됩니다.
+
+## 보안
+
+서버는 `127.0.0.1`에만 바인딩되며, 모든 API는 실행할 때마다 새로 만들어지는 토큰을 요구합니다.
+브라우저는 토큰이 포함된 URL로 자동으로 열립니다.
+
+## 요구 사항
+
+- Windows (Windows Terminal이 있으면 탭 기능 사용 가능)
+- Python 3.8+
+- Anaconda 또는 Miniconda
+
+## 라이선스
+
+MIT

ccdock-0.1.0/ccdock/__init__.py

@@ -0,0 +1,3 @@
+"""ccdock - Claude Code 프로젝트/가상환경 런처 대시보드."""
+
+__version__ = "0.1.0"

ccdock-0.1.0/ccdock/__main__.py

@@ -0,0 +1,61 @@
+"""ccdock 진입점."""
+
+import argparse
+import sys
+
+from . import __version__, launcher, scanner, server, store
+
+
+def _safe_console():
+    """cp949 콘솔에서도 한글 출력이 예외로 죽지 않게 한다."""
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(errors="replace")
+        except (AttributeError, ValueError):
+            pass
+
+
+def _cmd_list(args):
+    for i, p in enumerate(scanner.collect(), 1):
+        print("%3d  %-38s %-10s %s" % (
+            i, p["name"], scanner.relative_time(p["mtime"]), p["env"] or "-"))
+    return 0
+
+
+def _cmd_workspace(args):
+    cfg = store.load()
+    items = cfg.get("workspaces", {}).get(args.name)
+    if not items:
+        names = ", ".join(cfg.get("workspaces", {})) or "(없음)"
+        print("워크스페이스를 찾을 수 없습니다: %s" % args.name, file=sys.stderr)
+        print("저장된 워크스페이스: %s" % names, file=sys.stderr)
+        return 1
+    for r in launcher.launch_many(items, args.mode):
+        print(("  OK    " if r.get("ok") else "  실패  ") + str(r.get("path")))
+    return 0
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser(
+        prog="ccdock", description="Claude Code 프로젝트/가상환경 런처 대시보드")
+    ap.add_argument("-V", "--version", action="version", version="ccdock " + __version__)
+    ap.add_argument("-p", "--port", type=int, default=None, help="대시보드 포트")
+    ap.add_argument("-n", "--no-browser", action="store_true", help="브라우저를 열지 않음")
+    sub = ap.add_subparsers(dest="cmd")
+
+    sub.add_parser("list", help="프로젝트 목록을 터미널에 출력")
+    w = sub.add_parser("workspace", help="저장된 워크스페이스 실행")
+    w.add_argument("name")
+    w.add_argument("-m", "--mode", choices=("window", "tab"), default="window")
+
+    args = ap.parse_args(argv)
+    _safe_console()
+    if args.cmd == "list":
+        return _cmd_list(args)
+    if args.cmd == "workspace":
+        return _cmd_workspace(args)
+    return server.serve(port=args.port, open_browser=not args.no_browser)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

ccdock-0.1.0/ccdock/envs.py

@@ -0,0 +1,188 @@
+"""conda 가상환경 목록과 activate 스크립트 위치를 찾는다."""
+
+import json
+import os
+import subprocess
+import time
+from pathlib import Path
+
+HOME = Path.home()
+_cache = {"at": 0.0, "envs": None, "root": None}
+_TTL = 60.0
+
+_ROOT_CANDIDATES = (
+    "anaconda3", "miniconda3", "Anaconda3", "Miniconda3",
+    "AppData/Local/anaconda3", "AppData/Local/miniconda3",
+    "mambaforge", "miniforge3",
+)
+
+
+def conda_root():
+    """conda 설치 루트(base 경로)를 찾는다."""
+    if _cache["root"]:
+        return _cache["root"]
+    cands = []
+    for var in ("CONDA_ROOT", "CONDA_PREFIX_1", "CONDA_EXE"):
+        v = os.environ.get(var)
+        if not v:
+            continue
+        p = Path(v)
+        cands.append(p.parents[2] if var == "CONDA_EXE" and len(p.parents) > 2 else p)
+    for name in _ROOT_CANDIDATES:
+        cands.append(HOME / name)
+    cands.append(Path("C:/ProgramData/anaconda3"))
+    for c in cands:
+        try:
+            if (c / "Scripts" / "activate.bat").is_file():
+                _cache["root"] = c
+                return c
+        except OSError:
+            continue
+    return None
+
+
+def activate_bat():
+    root = conda_root()
+    return str(root / "Scripts" / "activate.bat") if root else None
+
+
+def _from_environments_txt():
+    """~/.conda/environments.txt - conda 를 실행하지 않고 즉시 읽는 빠른 경로."""
+    f = HOME / ".conda" / "environments.txt"
+    if not f.is_file():
+        return []
+    out = []
+    try:
+        for line in f.read_text(encoding="utf-8", errors="ignore").splitlines():
+            line = line.strip()
+            if line and os.path.isdir(line):
+                out.append(line)
+    except OSError:
+        return []
+    return out
+
+
+def _from_envs_dir():
+    root = conda_root()
+    if not root:
+        return []
+    out = [str(root)]
+    envs = root / "envs"
+    if envs.is_dir():
+        try:
+            out += [str(d) for d in envs.iterdir() if (d / "python.exe").is_file() or d.is_dir()]
+        except OSError:
+            pass
+    return out
+
+
+def _name_of(prefix, root):
+    p = Path(prefix)
+    if root and p == Path(root):
+        return "base"
+    return p.name
+
+
+def is_venv_id(env_id):
+    """환경 식별자가 conda 이름인지 venv 경로인지 구분한다."""
+    s = str(env_id or "")
+    return ("\\" in s) or ("/" in s)
+
+
+def venv_activate(prefix):
+    return str(Path(prefix) / "Scripts" / "activate.bat")
+
+
+def _is_venv(path):
+    p = Path(path)
+    try:
+        return (p / "pyvenv.cfg").is_file() and (p / "Scripts" / "activate.bat").is_file()
+    except OSError:
+        return False
+
+
+def scan_venvs(search_roots):
+    """프로젝트 폴더 바로 아래에 있는 venv 를 찾는다 (.venv, venv, *-env 등)."""
+    out, seen = [], set()
+    for root in search_roots or ():
+        try:
+            if not os.path.isdir(root):
+                continue
+            for d in os.scandir(root):
+                if not d.is_dir():
+                    continue
+                k = d.path.lower().rstrip("\\/")
+                if k in seen or not _is_venv(d.path):
+                    continue
+                seen.add(k)
+                out.append({
+                    "kind": "venv",
+                    "id": d.path,
+                    "name": d.name,
+                    "prefix": d.path,
+                    "where": os.path.basename(root) or root,
+                    "python": (Path(d.path) / "Scripts" / "python.exe").is_file(),
+                })
+        except OSError:
+            continue
+    out.sort(key=lambda e: (e["name"].lower(), e["where"].lower()))
+    return out
+
+
+def list_conda_envs(force=False):
+    """conda 환경 목록. [{'kind':'conda','id':이름,'name':이름,'prefix':...}]"""
+    now = time.time()
+    if not force and _cache["envs"] is not None and now - _cache["at"] < _TTL:
+        return _cache["envs"]
+
+    root = conda_root()
+    prefixes = _from_environments_txt() or _from_envs_dir()
+    seen, out = set(), []
+    for pre in prefixes:
+        k = str(pre).lower().rstrip("\\/")
+        if k in seen:
+            continue
+        seen.add(k)
+        name = _name_of(pre, root)
+        py = Path(pre) / "python.exe"
+        out.append({
+            "kind": "conda",
+            "id": name,
+            "name": name,
+            "prefix": str(pre),
+            "where": "conda",
+            "python": py.is_file(),
+        })
+    out.sort(key=lambda e: (e["name"] != "base", e["name"].lower()))
+    _cache["envs"], _cache["at"] = out, now
+    return out
+
+
+def _size_exclusions(entry):
+    """base 환경은 envs/ 와 pkgs/ 를 빼야 자기 자신의 크기가 나온다."""
+    if entry["kind"] == "conda" and entry["name"] == "base":
+        root = Path(entry["prefix"])
+        return (str(root / "envs"), str(root / "pkgs"))
+    return ()
+
+
+def list_envs(search_roots=None, force=False, with_size=True):
+    """conda 환경과 프로젝트 폴더의 venv 를 합쳐 돌려준다."""
+    from . import sizes
+
+    out = [dict(e) for e in list_conda_envs(force=force)]
+    known = {e["id"].lower() for e in out}
+    for v in scan_venvs(search_roots or []):
+        if v["id"].lower() not in known:
+            out.append(v)
+
+    if with_size:
+        for e in out:
+            s = sizes.get(e["prefix"], _size_exclusions(e))
+            e["size"] = s["bytes"] if s else None
+            e["files"] = s["files"] if s else None
+    return out
+
+
+def env_names():
+    return [e["name"] for e in list_conda_envs()]