@actor-kit/studio-cli
v0.2.0
Published
Read-only CLI and MCP server for Actor Kit Studio (inspect, timeline, view) behind Cloudflare Access
Maintainers
Readme
@actor-kit/studio-cli
Read-only access to Actor Kit Studio from a terminal or an agent: a CLI and an MCP server. Values are redacted by the actor before they leave it, and agents see hashed callers.
Install
pnpm add -D @actor-kit/studio-cliCLI
actor-kit studio list --type quiz
actor-kit studio inspect quiz room-42
actor-kit studio timeline quiz room-42 --limit 20 --shape
actor-kit studio view quiz room-42 --role player --caller alice| Command | What it returns |
|---|---|
| list | Actors (--type, --search, --limit, --offset) |
| types | Actor types |
| inspect <type> <id> | State, connections, outbox and links |
| timeline <type> <id> | Journal entries, newest first (--limit, --before); --shape returns cause types, payload keys, changed paths and checksums only |
| view <type> <id> --role <r> | What a role sees (--caller for per-caller views) |
The Worker origin comes from --url or ACTOR_KIT_STUDIO_URL.
Auth
| Environment | Use |
|---|---|
| CF_ACCESS_CLIENT_ID + CF_ACCESS_CLIENT_SECRET | An Access service token (agents) |
| CF_ACCESS_TOKEN | A person's token: cloudflared access token -app=<url> |
| none | Local wrangler dev |
MCP
actor-kit-studio-mcp serves the same read-only tools over stdio. timeline defaults to --shape, so an agent sees what changed without seeing values.
License
MIT
