feat: PyPI 배포 전환 (tako-shell) — 원라인 설치 + 슬래시 커맨드 동봉

[nonasking]

받는 사람이 깔아야 하는 별도 프로그램을 최소화하는 것이 목표. 기능은 그대로 유지한다.

왜

설치의 실제 병목은 Python 런타임이었다. macOS 기본 python 은 3.9.6 이라
requires-python >=3.10 에 걸려 pip install -e . 가 바로 실패하고, 그 뒤로
PEP 668 · PATH 문제가 줄줄이 따라온다. uv 가 이걸 통째로 흡수한다.

설치 방식만 바꾸면 슬래시 커맨드가 도달 불가능해진다는 문제가 딸려 나왔다 —
install.sh 는 저장소의 commands/*.md 를 심볼릭 링크하는데, PyPI 설치자는
저장소가 없다. 같이 고쳤다.

무엇

배포 채널

• 배포명 tako-shell (PyPI 의 tako 는 선점됨). 실행 명령어는 tako 그대로
• get-tako.sh — uv 탐지·설치 → PyPI 설치 → PATH 확인. curl | bash 를 꺼리는 쪽을 위해 PyPI/pipx 경로 병기
• ci.yml — macOS·Linux × Python 3.10·3.13 테스트 + 설치 스크립트 shellcheck
• release.yml — 태그 푸시 → 태그/버전 일치 검증 → 테스트 → 빌드 → PyPI Trusted Publishing (토큰 저장 없음)

슬래시 커맨드

• commands/ → tako/commands/ 이동, package-data 포함
• tako slash install [--force] / list / path 신설 — 동봉 사본을 ~/.claude/commands/ 로 복사
• 링크가 아니라 복사인 이유: 설치본 원본이 도구 환경 안에 있어 업그레이드·제거로 링크가 끊긴다
• 저장소에서 커맨드를 편집 하는 개발 흐름은 install.sh 의 링크 방식이 계속 담당

첫 실행

• 설정 없을 때 TTY 면 그 자리에서 init 제안. 비TTY(슬래시 커맨드·CI)는 종전대로 안내 후 exit 2 — 자동화가 입력을 기다리며 멈추지 않게 하고 테스트로 고정
• tako init 이 토큰 발급 페이지를 브라우저로 열어줌 (browser.py)
• 🐛 안내문이 cp config.example.yaml 을 시켰다 — PyPI 설치자에겐 없는 파일. 최소 YAML 을 본문에 직접 넣음
• 🐛 --credentials 커스텀 경로에서 자동 init 이 돌면 인증 파일만 기본 경로에 생기던 문제

검증

• 테스트 143개 통과 (+18: test_first_run.py, test_slash.py)
• 커밋 4개 각각 독립적으로 테스트 통과 확인
• 실제 휠을 깨끗한 venv 에 설치해 저장소 밖에서 검증 — 슬래시 설치·첫 실행 종료코드 기대대로

머지 후 필요한 것

1. PyPI → Publishing → Add a new pending publisher
   project: tako-shell / owner: nonasking / repo: tako / workflow: release.yml / environment: pypi
2. GitHub Settings → Environments → pypi 생성
3. git tag v0.1.0 && git push origin v0.1.0

get-tako.sh 의 raw URL 이 develop 을 가리키므로 머지 전에는 원라인 설치가 동작하지 않는다.

보류한 것

• Claude Code 플러그인 전환 — 기존 /tako 사용자에게 커맨드명이 깨지는 변경이라 설치 문제와 분리
• Homebrew 개인 tap, Windows 지원
• README 는 영어인데 CLI 출력·슬래시 커맨드는 한국어인 불일치

판단 근거와 재평가 트리거는 docs/distribution-review.md 에 남겼다. 특히 공개 배포에서는 단일 바이너리가 오히려 불리하다(브라우저 다운로드 경로에서만 Gatekeeper 가 작동) 는 점이 언어 재작성을 하지 않기로 한 축이었다.

⚠️ 기존 사용자 영향

commands/ 를 옮겼으므로 예전에 install.sh 로 링크해 쓰던 사람은 링크가 끊긴다.
./install.sh 재실행 또는 tako slash install --force 로 복구된다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FR3Lm3SnJ329MQV4SwTsut