btca-cli
Install, configure, and operate the btca CLI for local resources and source-first answers. Use when setting up btca in a project, connecting a provider, adding or managing resources, and asking questions via btca commands. Invoke this skill when the user says "use btca" or needs to do more detail...
SKILL.md
Full skill instructions
btca CLI
Setup From Scratch
- Ensure Bun is installed (see https://bun.sh if needed).
- Install the btca CLI globally:
bun add -g btca
- Initialize the project from the repo root:
btca init
Choose CLI for local resources.
- Connect a provider and model:
btca connect
Follow the prompts.
- Add resources:
# Git resource
btca add -n svelte-dev https://github.com/sveltejs/svelte.dev
# Local directory
btca add -n my-docs -t local /absolute/path/to/docs
- Verify resources:
btca resources
- Ask a question:
btca ask -r svelte-dev -q "How do I define remote functions?"
- Optional TUI:
btca
Common Tasks
- Ask with multiple resources:
btca ask -r react -r typescript -q "How do I type useState?"
- You can see which resources are configured with
btca resources.
Config Overview
- Config lives in
btca.config.jsonc(project) and~/.config/btca/btca.config.jsonc(global). - Project config overrides global and controls provider/model and resources.
Troubleshooting
- "No resources configured": add resources with
btca add ...and re-runbtca resources. - "Provider not connected": run
btca connectand follow the prompts.
