BoomTick is a consolidated developer toolkit and a high-performance content platform (boomtick.blog).
The core of this repository is a Vite-powered React application that serves as the boomtick.blog platform.
- Source Code: Located in the
src/directory. - Development:
pnpm dev
- Build:
pnpm build
The repository also includes a self-contained developer unit under the boomtick-pkg/ directory:
boomtick-pkg/cli/: A Python-based CLI (td) that serves as the unified entry point for repository automation, GitHub operations, and agent coordination.boomtick-pkg/mcp/: A Model Context Protocol (MCP) server that provides a structured interface for AI agents to interact with the repository.
To bootstrap the developer environment, install all dependencies, and initialize the toolkit, run:
bash boomtick-pkg/install.shThe primary tool for local automation. After installation, you can run:
td doctorto verify your runtime consistency.
A TypeScript-based MCP server communicating via stdio.
- Location:
boomtick-pkg/mcp/ - Build:
pnpm --filter ./boomtick-pkg/mcp build - Run:
node boomtick-pkg/mcp/dist/index.js
This repository uses a Schema-Driven Contract Pipeline. All AI agents MUST:
- Consult
.agent-context.jsonimmediately upon startup to discover available tools and CLI subcommands. - Follow the 'MCP-First' policy: Prioritize Tier 1 (MCP) tools and Tier 2 (
td) subcommands over raw shell commands (Tier 3). - Practice Self-Correction: If you catch yourself about to run a raw shell command that has a tool equivalent, stop and use the tool.
- CONTRIBUTING.md: Contribution guidelines and developer protocols.
- AGENTS.md: Rules and context for AI agents working in this repository.
- boomtick-pkg/README.md: Detailed package-level documentation.
This project is licensed under the Apache License 2.0. See the LICENSE file for details.