@spawn-dock/create

SpawnDock bootstrap CLI for local TMA projects.

This repository now follows an effect-template-style layout:

• root workspace with packages/app
• TypeScript + Effect entrypoint
• built-in TMA overlay bundled inside the CLI repo

The canonical TMA starter lives in https://github.com/SpawnDock/tma-project. @spawn-dock/create clones that repo, applies the bundled SpawnDock TMA overlay, and then writes project-specific runtime files.

Usage

npx -y @spawn-dock/create@beta --token <pairing-token> [project-dir]

If npm registry access is unavailable, the GitHub fallback remains:

npx --yes github:SpawnDock/create#main --token <pairing-token> [project-dir]

What it writes

• spawndock.config.json
• .env.local
• spawndock.dev-tunnel.json
• public/tonconnect-manifest.json

spawndock.config.json may include apiToken, and .env.local may include SPAWNDOCK_API_TOKEN, so the bundled TMA knowledge-search skill can use the authenticated API tier immediately after bootstrap.

Built-in Overlay

The package also ships a built-in TMA overlay and applies it after cloning SpawnDock/tma-project. This overlay is responsible for:

• AGENTS.md
• CLAUDE.md
• .agents/skills/tma-knowledge-search
• spawndock/dev.mjs
• spawndock/next.mjs
• spawndock/tunnel.mjs
• spawndock/mcp.mjs
• opencode.json
• .mcp.json
• next.config.ts
• public/tonconnect-manifest.json
• patching project scripts (pnpm run agent → node ./spawndock/agent.mjs, dev/tunnel helpers) and @spawn-dock/* packages

spawndock/mcp.mjs resolves <controlPlaneUrl>/mcp/sse from spawndock.config.json.

• opencode.json is shipped by the template for OpenCode.
• .mcp.json is shipped by the template for Claude Code.
• AGENTS.md is shipped by the template for repo-level AI agent instructions.
• CLAUDE.md is shipped by the template for Claude Code project memory.
• .agents/skills/tma-knowledge-search is shipped by the template as the local TMA knowledge-search skill for compatible agents.
• The bundled TMA knowledge-search skill is Node-based and runs via node .agents/skills/tma-knowledge-search/scripts/search_tma_knowledge.mjs "<query>".
• if codex is installed locally, bootstrap also registers the same MCP server in the global Codex MCP config automatically.
• bootstrap also mirrors tma-knowledge-search into ~/.codex/skills so Codex can discover the same skill natively.

Development

pnpm install
pnpm test
pnpm build