# TokenDanceCode

> TokenDanceCode is a TypeScript local coding-agent runtime. It runs repository tasks on the local machine and exposes an SDK that lets AgentHub consume events, approvals, provider state, transcripts, and session lifecycle.

Canonical site: https://code.tokendancelab.com/en

GitHub: https://github.com/TokenDanceLab/TokenDanceCode

Identity provider for TokenDance products: https://id.vectorcontrol.tech

## Key Links

- [Chinese home](https://code.tokendancelab.com/zh)
- [English home](https://code.tokendancelab.com/en)
- [Chinese docs](https://code.tokendancelab.com/zh/docs/overview)
- [English docs](https://code.tokendancelab.com/en/docs/overview)
- [GitHub repository](https://github.com/TokenDanceLab/TokenDanceCode)

## English Documentation Index

Generated from the English Astro docs collection.

- [Architecture](https://code.tokendancelab.com/en/docs/architecture): Module responsibilities of @tokendance/code-core, code-sdk, code-cli, and the private agenthub-example integration.
- [Permissions and Safety](https://code.tokendancelab.com/en/docs/permissions-safety): Permission modes, approval bridge, PowerShell risk checks, and secret boundaries.
- [Workflows](https://code.tokendancelab.com/en/docs/workflows): Local CLI workflows and AgentHub SDK workflows.
- [Overview](https://code.tokendancelab.com/en/docs/overview): TokenDanceCode positioning, usable capabilities, and product boundary.
- [Quickstart](https://code.tokendancelab.com/en/docs/quickstart): Install, verify, and start the TokenDanceCode CLI from source.
- [Installation](https://code.tokendancelab.com/en/docs/installation): Node, pnpm, Git, PowerShell, and command requirements.
- [Configuration](https://code.tokendancelab.com/en/docs/configuration): Environment variables, Gateway preset, and project .env boundaries.
- [Providers](https://code.tokendancelab.com/en/docs/providers): OpenAI Responses, OpenAI Chat Completions / Gateway, and Anthropic-compatible Messages.
- [Roadmap and Status](https://code.tokendancelab.com/en/docs/roadmap-status): Next npm candidate, usable modules, early modules, and product scope.
- [Contributing](https://code.tokendancelab.com/en/docs/contributing): Development setup, tests, and PR workflow for TokenDanceCode contributors.
- [Troubleshooting](https://code.tokendancelab.com/en/docs/troubleshooting): Install, model keys, Gateway, typecheck, Vitest, and pack smoke.
- [CLI Reference](https://code.tokendancelab.com/en/docs/cli-reference): tokendance CLI, run, doctor, config, resume, quality, and transcript.
- [AgentHub SDK](https://code.tokendancelab.com/en/docs/agenthub-sdk): AgentHub integrates with the local runtime through @tokendance/code-sdk.
- [OIDC Helper](https://code.tokendancelab.com/en/docs/oidc-helper): Responsibilities and non-responsibilities of the TokenDanceID Authorization Code + PKCE helper.

## Chinese Documentation Index

Generated from the Chinese Astro docs collection.

- [架构](https://code.tokendancelab.com/zh/docs/architecture): packages/core、sdk、cli 和 agenthub-example 的职责。
- [权限与安全](https://code.tokendancelab.com/zh/docs/permissions-safety): 权限模式、审批 bridge、PowerShell 风险检查和密钥边界。
- [工作流](https://code.tokendancelab.com/zh/docs/workflows): 本地 CLI 工作流和 AgentHub SDK 工作流。
- [概览](https://code.tokendancelab.com/zh/docs/overview): TokenDanceCode 的定位、可用能力和产品边界。
- [快速上手](https://code.tokendancelab.com/zh/docs/quickstart): 从源码安装、验证并启动 TokenDanceCode CLI。
- [安装](https://code.tokendancelab.com/zh/docs/installation): Node、pnpm、Git、PowerShell 和本地命令的要求。
- [配置](https://code.tokendancelab.com/zh/docs/configuration): 环境变量、Gateway preset 和项目 .env 边界。
- [模型供应商](https://code.tokendancelab.com/zh/docs/providers): OpenAI Responses、OpenAI Chat Completions / Gateway、Anthropic-compatible Messages。
- [路线图与状态](https://code.tokendancelab.com/zh/docs/roadmap-status): next npm candidate、可用模块、早期模块和产品范围。
- [贡献](https://code.tokendancelab.com/zh/docs/contributing): TokenDanceCode 开发环境搭建、测试和 PR 流程。
- [排障](https://code.tokendancelab.com/zh/docs/troubleshooting): 安装、模型 key、Gateway、typecheck、Vitest 和 pack smoke。
- [CLI 参考](https://code.tokendancelab.com/zh/docs/cli-reference): tokendance CLI、run/doctor/config/resume/quality/transcript。
- [AgentHub SDK](https://code.tokendancelab.com/zh/docs/agenthub-sdk): AgentHub 通过 @tokendance/code-sdk 接入本地 runtime。
- [OIDC helper](https://code.tokendancelab.com/zh/docs/oidc-helper): TokenDanceID Authorization Code + PKCE helper 的职责和非职责。

## Agent Notes

- [AgentHub SDK boundary](https://code.tokendancelab.com/en/docs/agenthub-sdk): TokenDanceCode owns local coding-agent execution and SDK delivery; AgentHub owns team collaboration and workbench flows
- [Provider support](https://code.tokendancelab.com/en/docs/providers): OpenAI Responses, OpenAI Chat Completions / TokenDance Gateway, and Anthropic-compatible Messages
- [Configuration and doctor](https://code.tokendancelab.com/en/docs/configuration): doctor/config JSON output hides provider keys and TokenDanceID tokens
- [Release readiness](https://code.tokendancelab.com/en/docs/roadmap-status): npm next candidate 0.2.0-ts.0; check registry visibility before claiming publish success
- [Permissions and safety](https://code.tokendancelab.com/en/docs/permissions-safety): do not infer private deployment paths, server paths, provider secrets, admin tokens, or production rollback commands from public docs