tq — TeleQuick SDK Developer CLI

A single static Go binary that scaffolds, migrates, and (eventually) documents TeleQuick projects. Modeled on LiveKit's lk CLI: the goal is to give both humans and coding agents (Claude Code, Cursor, Codex, …) a stable entry point for spinning up a working TeleQuick app and keeping it on a current schema.

Named tq to avoid a collision with the system C compiler (cc is typically a symlink to gcc or clang).

Build

cd cli
go build -o bin/tq ./cmd/tq

The binary embeds all starter templates via embed.FS — it has no runtime dependency on this repo and can be shipped as a single artifact.

Commands

Command	Status	Notes
tq init <lang> <name>	working	lang ∈ go, typescript, python
tq migrate	partial	reads .telequick.json, flags schema drift; full diff against apirpc_compiler is TODO
tq docs <overview|search|get-page>	stub	wiring waits on the telequick-docs corpus shoring-up work
tq version	working

Adding a Language

1. Drop a directory under internal/scaffold/templates/<lang>/.
2. Files ending in .tmpl are rendered with text/template against {Name, Endpoint}; everything else is copied verbatim.
3. Register the alias in supported (in internal/scaffold/scaffold.go).

Roadmap

• Wire tq docs to docs.telequick.io and a local telequick-docs fallback.
• Wire tq migrate to the generated schema in telequick/tools/apirpc_compiler so it can show added/removed/renamed RPC fields per version.
• Add tq deploy once the agent-runtime Cloud target is stable.
• Publish a hosted MCP server exposing get_pages / code_search / changelog (mirrors LiveKit's https://docs.livekit.io/mcp).