btca-cli

The btca-cli skill enables seamless integration of source-first research into your coding workflow. By acting as a specialized interface for the Better Context AI (btca) engine, it allows developers to hydrate git repositories, local directories, and npm packages into searchable context. Instead of relying on potentially outdated technical documentation or general LLM knowledge, users can ground their AI agent's responses directly in the current implementation of libraries, frameworks, and local project files. This skill is ideal for software engineers, library maintainers, and developers working in rapidly evolving codebases where precise, real-time code understanding is required to define functions, type complex objects, or debug deep implementation logic.

• Full lifecycle management of research resources, including adding git repositories, local directory paths, and specific npm packages via the command line.

• Contextual grounding for AI queries, enabling the agent to search specific library sources to answer complex technical questions.

• Support for both persistent project-level configurations and anonymous one-off research sessions for rapid, single-question debugging.

• Multi-resource querying capability, allowing the agent to synthesize information from multiple disparate sources simultaneously (e.g., comparing react and typescript definitions).

• Automated resource verification and environment synchronization to ensure the agent always operates on the most current code snapshots.

• When invoking the skill, provide clear resource names or paths to ensure the agent initializes the correct context window.

• Use the skill during complex architectural tasks where traditional documentation might be missing or misleading regarding current internal behavior.

• Expected inputs include natural language prompts paired with specific resource identifiers like git URLs or npm package names.

• Constraints include the need to have the btca server environment configured; ensure your project-specific or global btca.config.jsonc is correctly defined.

• For troubleshooting, use built-in CLI verification commands to list configured resources and connectivity status with your chosen provider.