Skip to content
btca-cli logo

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...

NeverSight/skills_feed0installs214stars

SKILL.md

Full skill instructions

btca CLI

Setup From Scratch

  1. Ensure Bun is installed (see https://bun.sh if needed).
  2. Install the btca CLI globally:
bun add -g btca
  1. Initialize the project from the repo root:
btca init

Choose CLI for local resources.

  1. Connect a provider and model:
btca connect

Follow the prompts.

  1. 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
  1. Verify resources:
btca resources
  1. Ask a question:
btca ask -r svelte-dev -q "How do I define remote functions?"
  1. 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-run btca resources.
  • "Provider not connected": run btca connect and follow the prompts.