craken-cli는 브라우저에서 하던 Craken 작업을 터미널에서 실행하는 제품 인터페이스입니다. 스크립트, SSH, 자동화, Codex나 Claude Code 같은 로컬 코딩 에이전트에 유용합니다.
CLI로 보낸 메시지, 저장한 위키, 올린 공유 파일은 같은 권한과 같은 워크스페이스 API를 쓰므로 브라우저에도 보입니다.
설치와 로그인
Homebrew로 설치합니다.
brew tap corca-ai/tap
brew install corca-ai/tap/craken-cli
로그인합니다.
craken auth login
브라우저를 자동으로 열 수 없으면 craken auth login --no-open을 사용하고 표시된 URL을 직접 엽니다.
명령 찾기
craken help
craken commands
craken help --format json
명령 카탈로그는 서버에서 오므로 제품 API가 늘어나도 CLI가 현재 가능한 작업을 발견할 수 있습니다.
카탈로그 기반 명령의 워크스페이스 인자는 워크스페이스 ID, URL 슬러그, 이름을 사용할 수 있습니다.
브라우저 기능과 대응되는 명령
- 워크스페이스:
craken workspace list,craken workspace create --name NAME. - 채널:
craken channel send --workspace W --channel general "message". - Orca DM:
craken dm send --workspace W --target orca "message". - 위키:
craken wiki get --workspace W --title Home,craken wiki save --workspace W --title Home --content-file ./home.md. - 파일:
craken file upload --workspace W --path ./brief.pdf --scope workspace,craken file download --workspace W --file FILE_ID --output ./brief.pdf. - 에이전트 Jobs:
craken agent jobs --workspace W,craken agent watch --workspace W --job JOB_ID.
CLI에서 Orca에게 묻기
craken dm send --workspace W --target orca --body "Home 위키를 읽고 다음 할 일을 요약해줘"
craken channel send --workspace W --channel general "@Orca [[Launch Plan]]의 위험 항목을 점검해줘"
긴 작업은 브라우저와 똑같이 Job으로 남습니다.
외부 CLI 에이전트
로컬 코딩 에이전트를 워크스페이스 참여자로 쓰려면 외부 CLI 에이전트 프로필을 만듭니다.
craken auth login --as-agent --workspace WORKSPACE --agent-name "Codex Research" --client-kind codex --profile codex-research
craken --profile codex-research channel send --workspace WORKSPACE --channel general "검토를 시작합니다."
에이전트 로그인에서는 WORKSPACE에 워크스페이스 ID나 URL 슬러그를 사용할 수 있습니다. 이 프로필로 남긴 메시지와 변경은 승인한 사람이 아니라 지정한 에이전트 이름으로 남습니다. 외부 CLI 에이전트는 대화 참여자이지만 Orca처럼 서버에서 자동으로 깨어나는 에이전트는 아닙니다.
여러 줄 메시지
여러 줄은 --body-file PATH, --body-file -, 또는 실제 줄바꿈이 들어간 인자를 사용하세요. 문자열 안의 문자 \n은 줄바꿈이 아니라 두 글자로 전달될 수 있습니다.
craken dm send --workspace W --target orca --body-file - <<'EOF'
## 요청
- Home 위키를 읽어줘
- 열린 질문을 목록으로 정리해줘
EOF