Query bknd with btca

btca is a CLI tool for asking questions about git repos. It clones repositories, indexes them, and answers queries using AI.

Quick Setup

# Install btca and OpenCode
bun add -g btca opencode-ai

# Configure model (Big Pickle: free, fast, surprisingly good)
btca config model --provider opencode --model big-pickle

# Add bknd as a resource
btca config resources add --name bknd --type git --url https://github.com/bknd-io/bknd --branch main

Or create btca.config.jsonc:

{
  "$schema": "https://btca.dev/btca.schema.json",
  "model": "big-pickle",
  "provider": "opencode",
  "providerTimeoutMs": 300000,
  "resources": [
    {
      "type": "git",
      "name": "bknd",
      "url": "https://github.com/bknd-io/bknd",
      "branch": "main"
    }
  ]
}

Core Commands

Ask a question

btca ask --resource bknd --question "How do I define a schema?"

Interactive chat

btca chat --resource bknd

Launch TUI

btca

Reference Files

For detailed information, see:

• •setup.md - Full installation, configuration options, resource management, troubleshooting setup issues
• •query-patterns.md - Specific query patterns for data, auth, media, adapters, and framework integration
• •advanced.md - Multi-resource queries, interactive workflows, performance optimization, debugging

Query Best Practices

1. •Be specific - "How do I define a schema with a one-to-many relation?" vs "How do I use the data module?"
2. •Provide context - "I'm using Cloudflare Workers. How do I configure the database adapter?"
3. •Ask for examples - "Show me a complete example of setting up password authentication"
4. •Reference specific files - "How does src/App.ts initialize the modules?"

Learning Workflow

1. •Explore high-level: Ask about overall architecture and main modules
2. •Module deep-dive: Use btca chat --resource bknd to focus on one module
3. •Implementation details: Ask to see specific feature implementations
4. •Examples & patterns: Query the examples directory for best practices

Resources

• •btca docs: https://btca.dev
• •bknd docs: https://docs.bknd.io
• •bknd repo: https://github.com/bknd-io/bknd