Krill CLI Docs

Quickstart

설치Install — /Applications/Krill.app + ~/.local/bin/krill— /Applications/Krill.app + ~/.local/bin/krill

$ curl -fsSL https://krill.page/install.sh | bash

상태 점검 · 에이전트 hook 설치Health check · install agent hooks

$ krill doctor
$ krill hook install claude

앱 없이 워크트리에서 에이전트 시작Start an agent in a worktree — no app needed

$ id=$(krill new --worktree feat-x --agent claude)
$ krill wait "$id" --for idle
$ krill read "$id" --lines 40

아무 터미널에서 같은 세션에 붙기Attach from any terminal Ctrl-] detach

$ krill attach "$id"

Sessions

krill ls [--json]세션 목록과 상태List sessions and their state

krill new [--cwd <path>] [--worktree <name>] [--agent <profile> | -- <program>…]새 세션 생성. 에이전트 프로필 또는 임의 프로그램Create a session running an agent profile or any program

krill send <id> [--enter] [--text <text>] [--stdin]세션에 입력 보내기Send input to a session

krill read <id> [--lines N]현재 화면·최근 출력 읽기Read the screen and recent output

krill attach <id>일반 터미널에서 세션에 접속(Ctrl-] 분리)Attach a regular terminal (Ctrl-] detaches)

krill kill <id>세션 종료(HUP → TERM → KILL)Terminate a session (HUP → TERM → KILL)

krill --host <user@host> lsSSH 유닉스 소켓 포워딩으로 원격 krilld 조작Drive a remote krilld over SSH Unix-socket forwarding

krill handoff --from <id> [--to-agent <agent>] [--prompt <text>]세션 맥락을 다른 에이전트에게 넘기기Hand a session's context to another agent

Worktrees & changes

krill worktree new <name> [--repo <path>] [--base <ref>] [--setup run|skip]git 워크트리 생성(+ 레포 setup 스크립트)Create a git worktree (optionally run repo setup)

krill worktree rm <path> [--force]워크트리 삭제Remove a worktree

krill changes [--repo <path>]변경 파일 목록List changed files

krill set --comment <text> | --workspace-status <…> | --pr <n>워크트리 메모·상태 배지·PR/이슈 연결Worktree comment, status badge, PR/issue link

krill reference list|add|remove <url>세션·워크트리에 참고 URL 묶기Attach reference URLs to a session or worktree

krill ports세션이 연 포트 보기Ports opened by sessions

Orchestration

krill orchestration run-create --title <t>오케스트레이션 런 생성Create an orchestration run

krill orchestration task-create --run <r> --title <t> [--deps t1,t2]의존성 있는 작업(DAG 노드) 추가Add a task (DAG node) with dependencies

krill orchestration worker-start --run <r> [--task <t>] --worker <name> [--agent <a>] [--cwd <dir>] --prompt <text>작업에 워커 에이전트 배정·기동Dispatch and boot a worker agent on a task

krill orchestration send | check [--wait] | ask | reply코디네이터↔워커 메시지, 블로킹 질문·답Coordinator ↔ worker messages, blocking ask/reply

krill orchestration gate-create --from <n> --question <q> [--options a,b]사람 결정 게이트 생성Open a human decision gate

krill orchestration gate-resolve <id> --decision <choice>게이트 결정Resolve a gate

krill orchestration worker-list | worker-read | worker-stop워커 상태·출력 확인, 정지Inspect, read and stop workers

Agents & hooks

krill agent list감지된 에이전트 프로필Detected agent profiles

krill account list|switch|add|rm|auto-switch에이전트 계정 전환·한도 소진 시 자동 전환Switch agent accounts, auto-switch on usage limits

krill skills list|get|install <name>에이전트 스킬 설치Install agent skills

krill schedule add <id> --cron '…' --prompt <text> -- <exe>cron(UTC) 예약 에이전트 실행Scheduled (UTC cron) agent runs

krill statusline [install|uninstall]Claude Code 상태 줄 연동Claude Code status line integration

Artifacts live

krill artifacts share <file> [--title <t>]HTML·Markdown을 share.krill.page에 공개Publish HTML/Markdown to share.krill.page

krill artifacts update|unshare <file>같은 링크 갱신·회수Update or withdraw the same link

krill artifacts list | delete <slug>내 공유물 목록·삭제List and delete your shares

Diagnostics & updates

krill doctor [--bundle | --json]holder·krilld·소켓·hook 진단, 지원용 번들Diagnose holder, krilld, socket and hooks; support bundle

krill update [--check] [--json]새 릴리스 확인·설치(세션 유지)Check for and install updates (sessions stay alive)

krill history clear콜드 스크롤백 기록 삭제Clear cold scrollback history

krill telemetry status|enable|disable텔레메트리 설정(기본 꺼짐)Telemetry setting (off by default)

Krill CLI 레퍼런스Krill CLI reference