btca

A CLI tool for asking questions about technologies using their source code repositories.

Installation

bun install

Usage

bun run src/index.ts

Or after building:

btca <command>

Commands

btca

Show version information.

btca ask

Ask a question about a technology.

btca ask -t <tech> -q <question>
btca ask --tech svelte --question "How do I create a reactive store?"

Options:

• -t, --tech - The technology/repo to query
• -q, --question - The question to ask

btca chat

Start an interactive TUI chat session.

btca chat -t <tech>
btca chat --tech nextjs

Options:

• -t, --tech - The technology/repo to chat about

btca serve

Start an HTTP server to answer questions via API.

btca serve
btca serve -p 3000

Options:

• -p, --port - Port to listen on (default: 8080)

Endpoint:

• POST /question - Send { "tech": "svelte", "question": "..." } to get answers

btca open

Hold an OpenCode instance in the background for faster subsequent queries.

btca open

btca config

Manage CLI configuration. Shows the config file path when run without subcommands.

btca config

btca config model

View or set the model and provider.

# View current model/provider
btca config model

# Set model and provider
btca config model -p <provider> -m <model>
btca config model --provider anthropic --model claude-3-opus

Options:

• -p, --provider - The provider to use
• -m, --model - The model to use

Both options must be specified together when updating.

btca config repos list

List all configured repositories.

btca config repos list

btca config repos add

Add a new repository to the configuration.

btca config repos add -n <name> -u <url> [-b <branch>] [--notes <notes>]
btca config repos add --name react --url https://github.com/facebook/react --branch main

Options:

• -n, --name - Unique name for the repo (required)
• -u, --url - Git repository URL (required)
• -b, --branch - Branch to use (default: "main")
• --notes - Special instructions for the AI when using this repo

Configuration

Configuration is stored at ~/.config/btca/btca.json. The config file includes:

• promptsDirectory - Directory for system prompts
• reposDirectory - Directory where repos are cloned
• port - Default server port
• maxInstances - Maximum concurrent OpenCode instances
• repos - Array of configured repositories
• model - AI model to use
• provider - AI provider to use