Claw Kanban

Claw-Kanban

AI 에이전트 오케스트레이션 칸반 보드
Claude Code, Codex CLI, Gemini CLI, OpenCode, GitHub Copilot, Google Antigravity에 역할 기반 자동 배정과 실시간 모니터링으로 태스크를 라우팅합니다.

AI로 설치하기 · 주요 기능 · 아키텍처 · API · English

--- ## AI로 설치하기 > **AI 코딩 에이전트 (Claude Code, Codex, Gemini CLI, Cursor 등)에 아래 문구를 붙여넣기만 하세요:** > > ``` > Claw-Kanban을 설치해줘. 가이드는 여기 참고: > https://github.com/GreenSheep01201/Claw-Kanban > ``` > > AI가 이 README를 읽고 모든 과정을 자동으로 처리합니다. --- ## AI 설치 가이드 > **이 섹션은 AI 코딩 에이전트를 위해 작성되었습니다.** > AI 어시스턴트로서 사용자가 Claw-Kanban 설치를 요청했다면, 아래 단계를 정확히 따르세요. 각 단계마다 검증 명령어가 포함되어 있으니, 실행 후 성공을 확인한 뒤 다음 단계로 진행하세요. ### Step 0: 사전 요구 사항 확인 ```bash # 1. Node.js 버전 확인 (22 이상 필수) node -v # 기대값: v22.x.x 이상. 없거나 v22 미만이면 중단하고 사용자에게 안내: # "Node.js 22+가 필요합니다. https://nodejs.org/ 에서 설치하거나 nvm을 사용하세요: nvm install 22" # 2. pnpm (권장) 또는 npm 확인 pnpm -v || npm -v # pnpm이 없으면 설치: # npm install -g pnpm # 3. AI CLI 도구가 하나 이상 있는지 확인 which claude || which codex || which gemini # 하나도 없으면 사용자에게 설치 안내: # Claude Code: npm i -g @anthropic-ai/claude-code && claude login # Codex CLI: npm i -g @openai/codex && codex auth login # Gemini CLI: npm i -g @google/gemini-cli && gemini auth login ``` ### Step 1: 클론 및 빌드 ```bash git clone https://github.com/GreenSheep01201/Claw-Kanban.git cd Claw-Kanban pnpm install # 또는: npm install pnpm build # 또는: npm run build ``` **검증:** `ls dist/index.html` 파일이 존재해야 합니다. ### Step 2: 서버 시작 ```bash pnpm start # 서버가 http://127.0.0.1:8787 에서 시작됩니다 ``` **검증:** `curl -s http://127.0.0.1:8787/api/health` 가 `{"ok":true, ...}` 를 반환해야 합니다. ### Step 3: 대시보드 열기 사용자에게 안내: ``` Claw-Kanban이 설치 완료되어 실행 중입니다! 대시보드: http://127.0.0.1:8787 ``` ### Step 3.5: AGENTS.md 설정 (필수) AI 에이전트 오케스트레이션에 **필수** 단계입니다. 이 설정이 없으면 AI 에이전트가 칸반 보드에 태스크를 등록하거나, 작업을 라우팅하거나, 카드를 관리할 수 없습니다. ```bash pnpm setup # 워크스페이스 AGENTS.md에 오케스트레이션 규칙을 추가합니다 ``` **검증:** 워크스페이스 `AGENTS.md` 상단에 ``가 포함되어 있어야 합니다. ### 선택: 개발 모드 핫 리로드로 개발하려면: ```bash pnpm dev # LAN 접근 가능 (0.0.0.0) pnpm dev:local # localhost만 (127.0.0.1) # UI: http://127.0.0.1:5173 | API: http://127.0.0.1:8787 ``` ### 문제 해결 | 증상 | 원인 | 해결 | |------|------|------| | `pnpm build`에서 "node:sqlite" 오류 | Node.js 22 미만 | Node.js 22+로 업그레이드: `nvm install 22 && nvm use 22` | | 포트 8787 이미 사용 중 | 다른 프로세스가 포트 점유 | `lsof -i :8787`로 확인하거나, `PORT=9999 pnpm start`로 포트 변경 | | `curl /api/health` 연결 거부 | 서버 미실행 | Claw-Kanban 디렉토리에서 `pnpm start` 실행 | | Settings에 AI 프로바이더 없음 | CLI 도구 미설치 | 최소 하나 설치: `npm i -g @anthropic-ai/claude-code` | | 프로바이더 "Not Authenticated" 표시 | CLI 도구 미로그인 | 인증 명령 실행: `claude login`, `codex auth login`, 또는 `gemini auth login` | --- ## 왜 만들었나? AI 코딩 에이전트(Claude Code, Codex CLI, Gemini CLI, OpenCode, Copilot, Antigravity)를 여러 개 쓰면 터미널 창을 여러 개 열어놓고 번갈아가면서 써야 하고, 태스크마다 어떤 에이전트를 쓸지 수동으로 결정하고, 끝날 때까지 하염없이 기다려야 합니다. Claw-Kanban은 이 문제를 해결합니다: - **역할별 에이전트 자동 배정** — 터미널 창 여러 개 열고 번갈아 쓸 필요 없음 - **에이전트 작업 실시간 확인** — 끝날 때까지 기다릴 필요 없이 지금 뭐 하고 있는지 바로 확인 - **폰으로 태스크 던지기** — Telegram에서 `# 버그 수정해줘` 보내면 에이전트가 알아서 처리 - **기존 CLI 환경 그대로 사용** — CLI 에이전트는 skills, MCP 서버, 커스텀 지시사항 등 기존 설정을 추가 구성 없이 그대로 가져옴 ## 이중 실행 모델 Claw-Kanban은 **6개 AI 에이전트**를 두 가지 실행 방식으로 지원합니다: ### CLI 에이전트 — 내 환경, 내 규칙 | 에이전트 | 실행 방식 | 설정 | |----------|-----------|------| | **Claude Code** | CLI spawn | `npm i -g @anthropic-ai/claude-code && claude login` | | **Codex CLI** | CLI spawn | `npm i -g @openai/codex && codex auth login` | | **Gemini CLI** | CLI spawn | `npm i -g @google/gemini-cli && gemini auth login` | | **OpenCode** | CLI spawn | `npm i -g opencode && opencode auth` | CLI 에이전트는 로컬에 설치된 실제 CLI 바이너리를 실행합니다. 즉 **기존에 구성한 개인화된 환경이 자동으로 그대로 적용**됩니다: - 직접 설정한 커스텀 skills와 agents - MCP 서버 연결 - 프로젝트별 지시사항 (CLAUDE.md 등) - 인증 및 API 키 - 모든 CLI 설정과 환경 변수 **추가 설정 불필요** — 터미널에서 `claude`, `codex`, `gemini`, `opencode`가 작동하면 Claw-Kanban에서도 그대로 작동합니다. 이것이 CLI 에이전트의 핵심 장점입니다: 기존 작업 환경을 그대로 사용합니다. ### HTTP 에이전트 — 설치 없이, OAuth만으로 | 에이전트 | 실행 방식 | 설정 | |----------|-----------|------| | **GitHub Copilot** | 직접 API 호출 | Settings > OAuth Connect > GitHub | | **Google Antigravity** | 직접 API 호출 | Settings > OAuth Connect > Google | HTTP 에이전트는 서버에서 프로바이더 API를 직접 호출합니다. CLI 설치 불필요 — Settings에서 GitHub 또는 Google 계정을 OAuth로 연결하면 됩니다. 토큰은 AES-256-GCM으로 암호화되어 서버에 저장됩니다. ## 주요 기능 - **6단계 칸반 보드** — Inbox, Planned, In Progress, Review/Test, Done, Stopped - **멀티 에이전트 오케스트레이션** — 6개 AI 에이전트 관리: Claude Code, Codex CLI, Gemini CLI, OpenCode, GitHub Copilot, Google Antigravity - **이중 실행 모델** — CLI 에이전트 (로컬 프로세스 생성, 기존 환경 상속) + HTTP 에이전트 (직접 API 호출, OAuth만 필요) - **역할 기반 자동 배정** — 역할(DevOps / Backend / Frontend)과 태스크 유형(New / Modify / Bugfix)에 따라 자동으로 에이전트 라우팅 - **AI 프로바이더 감지** — Settings에서 각 CLI 도구의 설치/인증 상태를 표시하고, 미인증 프로바이더는 드롭다운에서 비활성화 - **OAuth Connect (선택)** — CLI 인증이 불가능한 환경이거나 Copilot/Antigravity 사용 시; 브라우저로 연결하고 서버에 암호화 저장 - **자동 리뷰** — 구현 완료 후 Claude가 자동으로 리뷰/테스트 수행 - **실시간 터미널 뷰어** — 에이전트가 뭘 하고 있는지 브라우저에서 실시간 확인, 더 이상 하염없이 기다릴 필요 없음 - **채팅으로 카드 생성** — Telegram, Slack 등에서 `# 태스크 설명` 형식으로 보내면 칸반 카드가 즉시 생성 - **OpenClaw 게이트웨이 연동** — 카드 상태 변경 시 웨이크 알림 (선택사항) - **프로젝트 경로 안전장치** — 카드별 `project_path` 필드; 경로 미설정 시 에이전트 실행 차단 - **모던 다크 UI** — React 19, 반응형 디자인, 글래스모피즘 - **SQLite 저장소** — Node.js 내장 `node:sqlite`로 설정 없이 파일 기반 DB 사용 - **크로스 플랫폼** — macOS, Linux, Windows 지원 ## 스크린샷 ### 칸반 대시보드

Claw-Kanban 대시보드

> 6단계 칸반 보드와 카드 상세 패널. 태스크 생성, AI 에이전트 배정, 실시간 진행 상황 모니터링. ### 프로바이더 설정

프로바이더 설정

> 설치된 AI CLI 도구(Claude Code, Codex CLI, Gemini CLI)를 자동 감지하고 역할 기반 프로바이더 매핑을 설정합니다. ### 실시간 터미널 뷰어

터미널 뷰어

> 에이전트가 지금 뭘 하고 있는지 실시간으로 확인. 일을 시키고 끝날 때까지 하염없이 기다릴 필요 없이, 터미널 출력을 직접 확인할 수 있습니다. ### Telegram 연동

Telegram 연동

> Telegram에서 `# 버그 수정해줘` 이렇게 보내면 칸반 카드가 자동 생성되고 에이전트가 알아서 실행. 출퇴근길에 폰으로 태스크 던지면 집에 도착할 때쯤 완료되어 있습니다. ## 사전 요구 사항 - **Node.js 22+** (`node:sqlite` 사용을 위해 필수) - **pnpm** (권장) 또는 npm - 아래 중 하나 이상의 AI 에이전트 필요: **CLI 에이전트** — CLI 도구를 설치하고 인증합니다. 기존에 설정한 skills, agents, MCP 서버, 커스텀 지시사항이 자동으로 적용됩니다. | 도구 | 설치 | 인증 | |------|------|------| | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `npm i -g @anthropic-ai/claude-code` | `claude login` | | [OpenAI Codex CLI](https://github.com/openai/codex) | `npm i -g @openai/codex` | `codex auth login` | | [Google Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm i -g @google/gemini-cli` | `gemini auth login` | | [OpenCode](https://github.com/opencode-ai/opencode) | `npm i -g opencode` | `opencode auth` | **HTTP 에이전트** — CLI 불필요. 서버 시작 후 Settings에서 OAuth 연결만 하면 됩니다. | 도구 | 설정 | |------|------| | GitHub Copilot | Settings > OAuth Connect > GitHub | | Google Antigravity | Settings > OAuth Connect > Google | ## 빠른 시작 ### 원라인 설치 **macOS / Linux:** ```bash curl -fsSL https://raw.githubusercontent.com/GreenSheep01201/Claw-Kanban/main/install.sh | bash ``` **Windows (PowerShell):** ```powershell irm https://raw.githubusercontent.com/GreenSheep01201/Claw-Kanban/main/install.ps1 | iex ``` 설치 스크립트가 repo 클론, 의존성 설치, UI 빌드, `.env` 및 `AGENTS.md` 설정, 자동 시작 서비스 등록(macOS: launchd, Linux: systemd)을 모두 수행합니다. ### 수동 설치 ```bash git clone https://github.com/GreenSheep01201/Claw-Kanban.git cd Claw-Kanban pnpm install pnpm build ``` ### 실행 ```bash # 프로덕션 (빌드된 UI 서빙) pnpm start # 개발 모드 (Vite HMR + API 핫리로드, LAN 접근 가능) pnpm dev # 개발 모드 (localhost만) pnpm dev:local ``` | | URL | |---|---| | **UI** | http://127.0.0.1:5173 (개발) 또는 http://127.0.0.1:8787 (프로덕션) | | **API** | http://127.0.0.1:8787 | ## 동작 방식 ``` 1. 태스크 도착 (UI / API / 웹훅) ──> Inbox에 카드 생성 2. "Start" 클릭 또는 자동 배정 ──> 에이전트 실행: • CLI (Claude/Codex/Gemini/OpenCode) ──> CLI 프로세스 생성 (기존 환경 상속) • HTTP (Copilot/Antigravity) ──> 직접 API 호출 (OAuth 토큰) 3. 카드가 "In Progress"로 이동 ──> 실시간 터미널 로그 확인 가능 4. 에이전트 완료 (exit 0) ──> 카드가 자동으로 "Review/Test"로 이동 5. 자동 리뷰 시작 ──> Claude가 작업 결과 검토 6. 리뷰 통과 ──> 카드가 "Done"으로 이동 + 웨이크 알림 7. 리뷰 실패 ──> "Review/Test"에 유지, 문제점 보고 ``` ### 프로젝트 경로 에이전트가 **어떤 프로젝트 디렉토리**에서 작업할지 알아야 합니다. 카드 설명에 `## Project Path` 또는 `## 프로젝트 경로` 섹션을 포함하세요: ``` 로그인 버튼 스타일 수정 ## 프로젝트 경로 /Users/me/projects/my-app ``` 서버가 이 경로를 파싱해서 해당 디렉토리에서 AI 에이전트를 실행합니다 (`cwd`). 생략하면 Claw-Kanban 서버의 작업 디렉토리가 기본값으로 사용됩니다. Telegram/웹훅 메시지에서도 동일하게 포함하면 됩니다: ``` # 로그인 버튼 스타일 수정 ## 프로젝트 경로 /Users/me/projects/my-app ``` ### 태스크 흐름도 ``` ┌─────────┐ UI / API ──> │ Inbox │ 웹훅 ──> │ │ └────┬────┘ │ Start (수동 또는 자동) ┌────▼────┐ │ Planned │ (선택적 스테이징) └────┬────┘ │ ┌────▼─────────┐ │ In Progress │ <── CLI 에이전트 실행 중 │ (터미널 로그) │ └────┬─────────┘ │ exit 0 ┌────▼─────────┐ │ Review/Test │ <── Claude 자동 리뷰 └──┬────────┬──┘ 통과 │ │ 문제 발견 ┌───────▼┐ ┌───▼────┐ │ Done │ │Stopped │ └────────┘ └────────┘ ``` ## 설정 ### 환경 변수 `.env.example`을 `.env`로 복사: ```bash cp .env.example .env ``` | 변수 | 기본값 | 설명 | |------|--------|------| | `PORT` | `8787` | API 서버 포트 | | `HOST` | `127.0.0.1` | 바인드 주소 (LAN/Tailscale 접근 시 `0.0.0.0`) | | `DB_PATH` | `./kanban.sqlite` | SQLite 데이터베이스 파일 경로 | | `LOGS_DIR` | `./logs` | 에이전트 터미널 로그 디렉토리 | | `OPENCLAW_CONFIG` | *(비어있음)* | 게이트웨이 웨이크 연동을 위한 `openclaw.json` 경로 | ### 프로바이더 설정 (UI) UI에서 **Settings**를 열어 설정: | 섹션 | 설명 | |------|------| | **AI Providers** | Claude, Codex, Gemini의 설치/인증 상태 표시. Re-check 버튼으로 즉시 재감지. | | **Auto-assign** | 역할 기반 프로바이더 자동 배정 on/off | | **Role-based Providers** | DevOps / Backend 역할에 기본 프로바이더 매핑 | | **FrontEnd Providers** | New / Modify / Bugfix 태스크 유형에 프로바이더 매핑 | | **Stage-based Providers** | In Progress, Review/Test 단계별 프로바이더 오버라이드 (선택사항) | 기본 매핑: | 역할 | 태스크 유형 | 기본 프로바이더 | |------|-----------|---------------| | DevOps | — | Claude Code | | Backend | — | Codex CLI | | Frontend | New | Gemini CLI | | Frontend | Modify | Claude Code | | Frontend | Bugfix | Claude Code | ### AGENTS.md 연동 설정 스크립트가 워크스페이스의 `AGENTS.md`에 칸반 오케스트레이션 규칙을 추가합니다 (기존 내용은 유지): ```bash pnpm setup # 위치 자동 감지 pnpm setup -- --agents-path /path/to/AGENTS.md # 경로 직접 지정 ``` AI 에이전트가 `#`으로 시작하는 메시지를 태스크 요청으로 인식하고 칸반 보드에 등록하도록 학습시킵니다. ### OpenClaw 게이트웨이 `.env`에 `OPENCLAW_CONFIG`를 설정하여 웨이크 알림 활성화: ```bash OPENCLAW_CONFIG=~/.openclaw/openclaw.json ``` 웨이크 알림 발동 시점: - 새 Inbox 카드 생성 시 - Review/Test에서 Done으로 카드 이동 시 ## 아키텍처 ``` Claw-Kanban/ ├── server/ │ └── index.ts # Express 5 API 서버 │ # - SQLite 저장소 (node:sqlite) │ # - 에이전트 프로세스 생성/종료 │ # - CLI 감지 (GET /api/cli-status) │ # - 게이트웨이 웨이크 연동 ├── src/ │ ├── App.tsx # 칸반 보드 + Settings 모달 │ ├── App.css # 다크 테마 (CSS 변수) │ ├── api.ts # 프론트엔드 API 클라이언트 + TypeScript 타입 │ ├── main.tsx # React 19 엔트리 포인트 │ └── index.css # 기본/리셋 스타일 ├── public/ │ └── kanban-claw.svg # 앱 아이콘 (OpenClaw 랍스터 + 칸반 박스) ├── templates/ │ └── AGENTS-kanban.md # AGENTS.md 오케스트레이션 규칙 템플릿 ├── scripts/ │ ├── setup.mjs # AGENTS.md 설정 (덮어쓰기 아닌 앞에 추가) │ └── kanban.mjs # 프로세스 관리 (start/stop/status) ├── install.sh # 원라인 설치 스크립트 (macOS/Linux) ├── install.ps1 # 원라인 설치 스크립트 (Windows) ├── .env.example # 환경 변수 템플릿 ├── vite.config.ts # Vite 설정 (개발용 API 프록시) └── package.json ``` ### 기술 스택 | 계층 | 기술 | |------|------| | 프론트엔드 | React 19 + TypeScript + Vite | | 백엔드 | Express 5 + Node.js 22+ | | 데이터베이스 | SQLite (`node:sqlite`, 무의존성) | | CLI 에이전트 | Claude Code, Codex CLI, Gemini CLI, OpenCode (로컬 프로세스 spawn) | | HTTP 에이전트 | GitHub Copilot, Google Antigravity (직접 API + OAuth) | | 프로세스 관리 | Node `child_process` (CLI) + `fetch` 스트리밍 (HTTP) | ## API 레퍼런스 ### 카드 | 메소드 | 엔드포인트 | 설명 | |--------|-----------|------| | `GET` | `/api/cards` | 전체 카드 목록 (선택: `?status=Inbox`) | | `GET` | `/api/cards/search?q=키워드` | 모든 필드에서 카드 검색 | | `POST` | `/api/cards` | 카드 생성 | | `PATCH` | `/api/cards/:id` | 카드 필드 수정 | | `DELETE` | `/api/cards/:id` | 카드 및 모든 관련 파일 삭제 | | `POST` | `/api/cards/purge?status=Done` | 상태별 일괄 삭제 | ### 에이전트 제어 | 메소드 | 엔드포인트 | 설명 | |--------|-----------|------| | `POST` | `/api/cards/:id/run` | 에이전트 시작 (CLI 프로세스 생성) | | `POST` | `/api/cards/:id/stop` | 실행 중인 에이전트 중지 (프로세스 트리 종료) | | `POST` | `/api/cards/:id/review` | 수동으로 리뷰 시작 | | `GET` | `/api/cards/:id/terminal` | 터미널 출력 스트리밍 (`?lines=200&pretty=1`) | | `GET` | `/api/cards/:id/logs` | 카드 이벤트 로그 조회 | ### 설정 및 상태 | 메소드 | 엔드포인트 | 설명 | |--------|-----------|------| | `GET` | `/api/settings` | 프로바이더 설정 조회 | | `PUT` | `/api/settings` | 프로바이더 설정 저장 | | `GET` | `/api/cli-status` | CLI 설치/인증 상태 감지 (30초 캐시, `?refresh=1`로 우회) | ### 웹훅 ```bash POST /api/inbox Content-Type: application/json { "text": "# 로그인 버그 수정", "source": "telegram", "author": "user123" } ``` ### 헬스 체크 ```bash GET /api/health # { ok, version, dbPath, gateway } ``` ## CLI 감지 `/api/cli-status` 엔드포인트의 감지 방식: | 항목 | 방법 | |------|------| | **설치 확인** | `which` (Unix) / `where` (Windows) + `--version` | | **Claude 인증** | `~/.claude.json`에 `oauthAccount` 키 존재 여부 | | **Codex 인증** | `~/.codex/auth.json`에 `OPENAI_API_KEY` 또는 `tokens` 키 존재; `OPENAI_API_KEY` 환경변수 폴백 | | **Gemini 인증** | `~/.gemini/oauth_creds.json`에 `access_token` 키 존재; Windows에서는 `%APPDATA%\gcloud\application_default_credentials.json`도 확인 | 결과는 30초간 캐시됩니다. `?refresh=1`로 즉시 재확인 가능합니다. ## 보안 Claw-Kanban은 **로컬 개발 도구**입니다. 주의 사항: - **인증 없음** — 기본값 `127.0.0.1`로 바인딩. 신뢰할 수 있는 네트워크(VPN/Tailscale)에서만 `0.0.0.0` 사용. - **에이전트 권한 플래그** — `--dangerously-skip-permissions` (Claude), `--yolo` (Codex/Gemini)로 자율 실행. - **환경 변수 상속** — 자식 프로세스가 서버의 환경 변수를 상속받음. - **CORS** — Vite 개발 프록시를 위해 오픈 CORS 활성화. 공개 인터넷에 노출하지 마세요. - **OAuth 토큰 저장** — OAuth 토큰은 **서버 측 SQLite에만 저장**되며 `OAUTH_ENCRYPTION_SECRET` 환경 변수를 사용해 AES-256-GCM으로 암호화됩니다. 브라우저에는 refresh token이 전달되지 않습니다. - **내장 OAuth Client ID** — 소스 코드에 포함된 GitHub/Google OAuth client ID와 secret은 **공개 OAuth 앱 자격증명**이며 사용자 비밀이 아닙니다. [Google 문서](https://developers.google.com/identity/protocols/oauth2/native-app)에 따르면 설치형/데스크톱 앱의 client secret은 "secret으로 취급하지 않습니다." VS Code, Thunderbird, GitHub CLI 등 오픈소스 앱도 동일한 방식을 사용합니다. 이 자격증명은 앱 자체를 식별할 뿐 — 사용자 개인 토큰은 항상 별도로 암호화 저장됩니다. - **소스 코드에 개인 자격증명 없음** — 사용자별 토큰(GitHub, Google OAuth)은 로컬 SQLite에 암호화 저장되며 소스 코드에 포함되지 않습니다. 암호화 키는 `OAUTH_ENCRYPTION_SECRET` 환경 변수에서 생성됩니다. - **Copilot 토큰 캐싱** — 교환된 Copilot 세션 토큰은 메모리에만 캐시(디스크 미기록)되고 자동 만료됩니다. 재인증 시 캐시가 즉시 무효화됩니다. ## 플랫폼 지원 | 플랫폼 | 상태 | 비고 | |--------|------|------| | macOS | 테스트 완료 | 주 개발 플랫폼. 100% 동작 확인. launchd 자동 시작. | | Linux | 완전 지원 | systemd 사용자 서비스 자동 시작. | | Windows | 테스트 중 | PowerShell 설치 스크립트 제공. 곧 100% 호환 예정. | ## 서비스 관리 ```bash # 관리 스크립트 사용 node scripts/kanban.mjs status # 서버 실행 상태 확인 node scripts/kanban.mjs start # 백그라운드 시작 node scripts/kanban.mjs stop # 서버 중지 node scripts/kanban.mjs restart # 서버 재시작 # macOS (launchd) launchctl kickstart -k gui/$(id -u)/ai.openclaw.kanban # 재시작 launchctl bootout gui/$(id -u)/ai.openclaw.kanban # 중지 # Linux (systemd) systemctl --user restart claw-kanban systemctl --user stop claw-kanban systemctl --user status claw-kanban ``` ## 변경 이력 ### v1.0.3 - **`POST /api/wake` 엔드포인트 추가** — 외부 `openclaw` CLI 없이 HTTP(`curl`)로 웨이크 알림 전송 가능 - **AGENTS.md 템플릿 업데이트** — `openclaw gateway wake` 명령을 새 `/api/wake` 엔드포인트의 `curl` 명령으로 교체 ### v1.0.2 - **GitHub Copilot 직접 API** — OAuth 토큰 교환 + OpenAI 호환 chat completions 스트리밍, opencode CLI 불필요 - **Google Antigravity 직접 API** — `cloudcode-pa` 엔드포인트로 GCP 프로젝트 자동 탐색 (`loadCodeAssist`), 투명한 토큰 갱신 - **이중 실행 모델** — CLI 에이전트 (Claude/Codex/Gemini/OpenCode)는 로컬 프로세스로 기존 환경 상속; HTTP 에이전트 (Copilot/Antigravity)는 OAuth로 직접 API 호출 - **경합 조건 수정** — DB 쓰기를 비동기 HTTP 에이전트 시작 전에 동기적으로 실행 - **Copilot 토큰 캐시 수정** — 재인증 후 오래된 자격증명 사용 방지 (sourceHash 검증 추가) - **SSE 스트림 수정** — 최종 버퍼 플러시, 로그 스트림 await 처리, 음수 PID 처리 ### v1.0.1 - **`project_path` 전용 필드** — 카드에 전용 `project_path` 컬럼 추가 - **실행/리뷰 가드** — `project_path` 미설정 시 `/run`과 `/review` 차단 - **Windows 프로세스 관리 수정** — `killPidTree`에 `taskkill` + 타임아웃 적용 - **UI 개선** — 카드 생성 및 상세 패널에 프로젝트 경로 입력 추가 ### v1.0.0 - 최초 릴리즈 ## 라이선스 Apache License 2.0 — 자세한 내용은 [LICENSE](LICENSE)를 참조하세요. Copyright 2025 GreenSheep01201