Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Tintpad는 Claude Code와 Codex를 위한 무료 오픈 소스 macOS 런처입니다. 이 도구는 단축키(Hotkey)를 통해 저장소에 접근하고 터미널을 열어 에이전트를 즉시 실행할 수 있게 합니다. 사용자는 이를 활용하여 개발 워크플로우를 간편하게 관리할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기노치(notch)에서 떨어져 나옵니다.
A free, open source macOS launcher for Claude Code and Codex (Claude Code와 Codex를 위한 무료 오픈 소스 macOS 런처).<br/>
단축키(Hotkey), 저장소(repo), Enter 키. 터미널이 해당 저장소에서 열리며 에이전트가 이미 실행된 상태입니다.
macOS용 다운로드
· brew install --cask sorkila/tap/tintpad
CI
Latest release
macOS 14+
License: MIT
<a href="https://tintpad.com"><img src="https://raw.githubusercontent.com/sorkila/tintpad/HEAD/docs/assets/demo.gif" alt="Tintpad demo: a black drop hangs from the MacBook notch with repo names inside. Keycaps show each shortcut as it is pressed: ⌥⌘Space summons it, → walks a white chip through the repos, tab switches the agent between Claude Code and Codex, and ⇧tab turns the MODE chip red for Skip permissions" width="100%" /></a>
</div>Tintpad.dmg 다운로드
(서명 및 공증됨, macOS 14 이상) 또는 위의 brew 명령어를 사용합니다. Homebrew는 tap을 신뢰할지 한 번 요청하므로, 예라고 답하세요 (brew trust sorkila/tap를 미리 실행하면 됩니다).
또는 직접 빌드할 수 있습니다 (Swift 6, Xcode 16+):
git clone https://github.com/sorkila/tintpad.git && cd tintpad
swift run # 개발 환경에서 실행
./Scripts/package.sh # .build/release 폴더에 Tintpad.app 생성
에이전트를 가져오세요: 먼저 claude, codex 또는 다른 에이전트 CLI를 설치해야 합니다.
또한 조용한 문제를 해결합니다. GUI 앱은 셸의 PATH를 상속받지 못하기 때문에, 더블 클릭된 앱이 claude를 전혀 찾을 수 없습니다. Tintpad는 로그인 셸(login shell)을 한 번 읽고 넘어갑니다.
권한 문제 때문입니다. 실행 문제가 발생하면 드롭(drop)에 빨간색 선으로 표시되며, 이 선에서 Return을 누르면 올바른 시스템 설정(System Settings) 패널이 열립니다. 접근성(Accessibility)에 Tintpad가 켜져 있다고 나오지만 아무 일도 일어나지 않는다면, macOS가 오래된 권한 부여(stale grant)를 가지고 있는 것입니다. 마이너스 버튼으로 Tintpad를 제거하고 다시 추가한 후 재시작하세요.
| Key | Action |
|---|---|
| <kbd>⌥⌘Space</kbd> | 소환 (설정 → 키) |
| ... | |
| <kbd>⌘</kbd>를 잠시 누르고 있으면 드롭(drop)에 각 리포지토리의 번호와 각 칩의 키가 표시됩니다. 메뉴 바의 팔레트 키(Palette keys) 메뉴와 설정(Settings) → 키(Keys) 목록에서 이 표를 확인할 수 있습니다. |
에이전트는 변수가 포함된 커맨드 템플릿일 뿐입니다. **설정(Settings) → 에이전트(Agents)**에서 설정하세요:
claude {mode} {prompt}
변수: {repoPath} {repoName} {branch} {remote} {prompt} {mode} {shell} {worktreePath} {continue}. 삽입된 모든 값은 실행되기 전에 정리(sanitized)되고 셸 따옴표 처리(shell-quoted)됩니다.
<kbd>⌃R</kbd> 및 <kbd>⌘0</kbd>을 실행하면 에이전트의 Continue 폼(Claude Code의 경우 --continue, Codex의 경우 resume --last)이 {continue}에서, 또는 템플릿에 슬롯이 없는 경우 바이너리 직후에 실행됩니다. 이를 지원하지 않는 에이전트는 그렇게 명시하고 아무것도 실행하지 않습니다. 에이전트는 디렉터리별로 대화를 유지하므로, 작업 공간(worktree)으로 시작된 세션은 그곳에서 계속되며, claude -w 작업 공간에 있는 세션은 Tintpad의 시야 밖에 있습니다.
PR을 환영합니다. 특히 새로운 터미널 어댑터가 좋습니다. 각기 하나의 프로토콜과 하나의 구조체(struct)를 추가해 주세요. CONTRIBUTING.md와 docs/ARCHITECTURE.md를 참조하세요.
Lockpaw는 이 루프의 다른 절반입니다. Tintpad가 에이전트를 시작하면, Lockpaw는 에이전트가 실행되는 동안 화면을 덮고 필요할 때 빛을 발합니다. 또한 무료이며 MIT 라이선스입니다.
전체 시스템이 무료이며 MIT 라이선스입니다. 잠금 해제할 것이 없고, Pro 버전도 없습니다. 만약 이 도구가 아침 시간을 절약해 준다면, GitHub에서 후원해주세요 →