CLI command reference

Status

このページは current CLI registry に合わせています。Takos CLI は task-oriented で、takos api ... や HTTP verb style subcommand は current surface ではありません。

Top-level commands

auth

takos login
takos whoami
takos logout

endpoint

takos endpoint use test
takos endpoint use prod
takos endpoint use https://api.takos.dev
takos endpoint show

deploy

takos deploy --space SPACE_ID --repo REPO_ID --ref main
takos deploy validate
takos deploy status --space SPACE_ID
takos deploy status APP_DEPLOYMENT_ID --space SPACE_ID
takos deploy rollback APP_DEPLOYMENT_ID --space SPACE_ID

takos deploy は repo-local .takos/app.yml と、指定 repo/ref に紐づく workflow artifact を使って app deployment を作成します。

Task domains

Takos CLI の中心は takos <domain> <task> です。domain は current registry では次の 20 個です。

domain	aliases	主な path/family
me	-	/api/me
setup	-	/api/setup
workspace	ws	/api/spaces
project	-	/api/projects
thread	-	/api/threads, /api/spaces/:spaceId/threads
run	-	/api/runs, /api/threads/:threadId/runs
artifact	-	/api/artifacts
task	-	/api/agent-tasks
repo	-	/api/repos と actions/pulls/release 系
worker	-	/api/workers
app	-	/api/apps
resource	-	/api/resources
git	-	/api/git
capability	cap	skills / tools 系
context	ctx	memories / reminders 系
shortcut	-	/api/shortcuts
notification	-	/api/notifications
public-share	-	/api/public/thread-shares
auth	-	/api/auth/*, /api/me/oauth/*
discover	-	search / install 系

Shared task verbs

すべての task domain は共通して次を持ちます。

• list
• view
• create
• replace
• update
• remove
• probe
• describe

stream 系 domain は追加で次を持ちます。

• watch
• follow

Representative examples

takos workspace list
takos workspace create --body '{"name":"my-workspace"}'

takos thread create /spaces/SPACE_ID/threads --body '{"title":"debug"}'
takos run follow RUN_ID --transport sse
takos repo follow REPO_ID RUN_ID --transport ws

takos capability list /spaces/SPACE_ID/skills
takos context list /spaces/SPACE_ID/memories
takos notification watch /sse --transport sse

Removed legacy surface

次は current CLI surface ではありません。

• takos api ...
• takos build
• takos publish
• takos promote
• takos rollback as a top-level command
• takos mcp
• takos pat
• takos pr
• takos actions
• takos memory
• takos reminder
• takos skill
• takos tool
• takos oauth
• takos search
• takos install
• takos <domain> get/post/patch/delete/...

merge 済み domain の対応は次です。

old	current
pr, actions	repo
memory, reminder	context
skill, tool	capability
oauth	auth
search, install	discover