1. 설치 및 인증 (Installation & Auth)
SETUP
패키지 글로벌 설치CLI
npm i -g @tpi/basecamp-cli
API 토큰 로그인AUTH
tpi-basecamp auth login --token <API_TOKEN>
현재 인증 상태 및 계정 확인CHECK
tpi-basecamp auth status
2. 핵심 작업 패턴 (Core Command Patterns)
COMMANDS
프로젝트 목록 탐색 (JSON)NAV
tpi-basecamp projects list --json
할 일 생성 및 담당자/마감일 지정TODOS
tpi-basecamp todos create --set-id 901 --content "TPI 모듈 통합" --assignee 402 --due 2025-04-01
할 일 완료 처리TODOS
tpi-basecamp todos complete --todo-id 8820 --json
칸반 카드 상태/컬럼 이동KANBAN
tpi-basecamp cards move --card-id 5501 --column "진행중"
메시지 작성 & 확정적 멘션 첨부MESSAGE
tpi-basecamp messages post --board-id 201 --title "배포 완료" --content "정산 검증 [@김철수](mention:9901)"
볼트 파일 업로드FILES
tpi-basecamp files upload --vault-id 301 --path ./report.pdf
다가오는 일정 및 마감 목록SCHEDULE
tpi-basecamp schedule list --range upcoming --json
3. 브레드크럼 체이닝 & 메타 탐색
INTROSPECTION
리소스 경로 직접 탐색 및 스키마 자가 점검SELF-HELP
tpi-basecamp 901/todos/8820 --agent --help
하위 리소스 연속 추적 체이닝CHAIN
tpi-basecamp chain --path "projects/901/todolists/11/comments"
4. 에이전트 6대 불변 규칙
MUST-FOLLOW
- 1. 변경 작업 실행 전 `--ids-only` 또는 사전 조회로 리소스 ID 검증.
- 2. 자율 자동화 구동 시 반드시 `--agent` 플래그를 추가할 것.
- 3. 파싱 안정성을 위해 항상 `--json` 또는 `--jq` 명령 결과 사용.
- 4. 멘션 작성 시 `[@이름](mention:SGID)` 고정 규격을 준수할 것.
- 5. 실행 시 프로젝트 루트의 `.basecamp/config.json`을 최우선 참조.
- 6. 모호성 발생 시 즉시 `--agent --help` 및 `doctor` 진단 수행.
5. 프로필 (Multi-Agent Identities)
PROFILE
새 에이전트 프로필 생성PROFILE
tpi-basecamp profile add dev-agent --token <TOK>
기본 프로필 지정DEFAULT
tpi-basecamp profile set-default dev-agent
특정 프로필로 일회성 명령 실행EXEC
tpi-basecamp --profile deploy-bot todos list
6. 로컬 설정 (.basecamp/config.json)
CONFIG
{
"account_id": "tpi-corp-main",
"project_id": 901,
"default_output": "agent",
"strict_mentions": true
}
7. 출력 모드 (Output Modes)
OUTPUT
| 플래그 | 설명 및 용도 |
|---|---|
--json |
원시 데이터 구조체 파싱용 |
--agent |
LLM 문맥 압축 텍스트 반환 |
--jq <expr> |
특정 필드 추출 (예: .id) |
--md |
마크다운 보고서 렌더링용 |
--ids-only |
파이프라인 연동용 ID 목록 |
8. 트러블슈팅 (Troubleshooting)
DIAGNOSTICS
환경 및 권한 시스템 종합 진단DOCTOR
tpi-basecamp doctor
비인터랙티브 세션 토큰 검증AUTH
tpi-basecamp auth check --non-interactive
로컬 JSON 설정 규격 검사VALIDATE
tpi-basecamp config validate