btca 0.2.0 → 0.2.1

package/README.md

@@ -1,15 +1,137 @@
-# cli
+# btca
 
-To install dependencies:
+A CLI tool for asking questions about technologies using their source code repositories.
+
+## Installation
 
 ```bash
 bun install
 ```
 
-To run:
+## Usage
+
+```bash
+bun run src/index.ts
+```
+
+Or after building:
+
+```bash
+btca <command>
+```
+
+## Commands
+
+### `btca`
+
+Show version information.
+
+### `btca ask`
+
+Ask a question about a technology.
+
+```bash
+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.
+
+```bash
+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.
+
+```bash
+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.
+
+```bash
+btca open
+```
+
+### `btca config`
+
+Manage CLI configuration. Shows the config file path when run without subcommands.
 
 ```bash
-bun run index.ts
+btca config
 ```
 
-This project was created using `bun init` in bun v1.3.3. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+#### `btca config model`
+
+View or set the model and provider.
+
+```bash
+# 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.
+
+```bash
+btca config repos list
+```
+
+#### `btca config repos add`
+
+Add a new repository to the configuration.
+
+```bash
+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

package/dist/index.js

@@ -60472,9 +60472,10 @@ var DEFAULT_CONFIG = {
       specialNotes: "This is the svelte docs website repo, not the actual svelte repo. Use the docs to answer questions about svelte."
     },
     {
-      name: "effect",
-      url: "https://github.com/Effect-TS/effect",
-      branch: "main"
+      name: "tailwindcss",
+      url: "https://github.com/tailwindlabs/tailwindcss.com",
+      branch: "main",
+      specialNotes: "This is the tailwindcss docs website repo, not the actual tailwindcss repo. Use the docs to answer questions about tailwindcss."
     },
     {
       name: "nextjs",
@@ -60485,6 +60486,29 @@ var DEFAULT_CONFIG = {
   model: "big-pickle",
   provider: "opencode"
 };
+var collapseHome = (path2) => {
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+  if (home && path2.startsWith(home)) {
+    return "~" + path2.slice(home.length);
+  }
+  return path2;
+};
+var writeConfig = (config2) => exports_Effect.gen(function* () {
+  const path2 = yield* exports_Path.Path;
+  const fs = yield* exports_FileSystem.FileSystem;
+  const configDir = yield* expandHome(CONFIG_DIRECTORY);
+  const configPath = path2.join(configDir, CONFIG_FILENAME);
+  const configToWrite = {
+    ...config2,
+    promptsDirectory: collapseHome(config2.promptsDirectory),
+    reposDirectory: collapseHome(config2.reposDirectory)
+  };
+  yield* fs.writeFileString(configPath, JSON.stringify(configToWrite, null, 2)).pipe(exports_Effect.catchAll((error4) => exports_Effect.fail(new ConfigError({
+    message: "Failed to write config",
+    cause: error4
+  }))));
+  return configToWrite;
+});
 var OPENCODE_CONFIG = (args2) => exports_Effect.gen(function* () {
   const path2 = yield* exports_Path.Path;
   return {
@@ -60583,7 +60607,7 @@ var onStartLoadConfig = exports_Effect.gen(function* () {
 var configService = exports_Effect.gen(function* () {
   const path2 = yield* exports_Path.Path;
   const loadedConfig = yield* onStartLoadConfig;
-  const { config: config2, configPath } = loadedConfig;
+  let { config: config2, configPath } = loadedConfig;
   const getRepo = ({
     repoName,
     config: config3
@@ -60619,7 +60643,23 @@ var configService = exports_Effect.gen(function* () {
         specialNotes: repo?.specialNotes
       });
     }),
-    rawConfig: () => exports_Effect.succeed(config2)
+    rawConfig: () => exports_Effect.succeed(config2),
+    getRepos: () => exports_Effect.succeed(config2.repos),
+    getModel: () => exports_Effect.succeed({ provider: config2.provider, model: config2.model }),
+    updateModel: (args2) => exports_Effect.gen(function* () {
+      config2 = { ...config2, provider: args2.provider, model: args2.model };
+      yield* writeConfig(config2);
+      return { provider: config2.provider, model: config2.model };
+    }),
+    addRepo: (repo) => exports_Effect.gen(function* () {
+      const existing = config2.repos.find((r) => r.name === repo.name);
+      if (existing) {
+        return yield* exports_Effect.fail(new ConfigError({ message: `Repo "${repo.name}" already exists` }));
+      }
+      config2 = { ...config2, repos: [...config2.repos, repo] };
+      yield* writeConfig(config2);
+      return repo;
+    })
   };
 });
 
@@ -60800,7 +60840,7 @@ class OcService extends exports_Effect.Service()("OcService", {
 }
 
 // src/services/cli.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 var programLayer = exports_Layer.mergeAll(OcService.Default, ConfigService.Default);
 var questionOption = exports_Options.text("question").pipe(exports_Options.withAlias("q"));
 var techOption = exports_Options.text("tech").pipe(exports_Options.withAlias("t"));
@@ -60892,11 +60932,93 @@ var serveCommand = exports_Command2.make("serve", { port: portOption }, ({ port:
   const HttpLive = router.pipe(exports_HttpServer.serve(), exports_HttpServer.withLogAddress, exports_Layer.provide(ServerLive));
   return yield* exports_Layer.launch(HttpLive);
 }).pipe(exports_Effect.scoped, exports_Effect.provide(programLayer)));
-var configPathCommand = exports_Command2.make("config", {}, () => exports_Effect.gen(function* () {
+var providerOption = exports_Options.text("provider").pipe(exports_Options.withAlias("p"), exports_Options.optional);
+var modelOption = exports_Options.text("model").pipe(exports_Options.withAlias("m"), exports_Options.optional);
+var configModelCommand = exports_Command2.make("model", { provider: providerOption, model: modelOption }, ({ provider, model }) => exports_Effect.gen(function* () {
   const config2 = yield* ConfigService;
-  const configPath = yield* config2.getConfigPath();
-  console.log(`Update your config file at ${configPath}`);
+  if (provider._tag === "Some" && model._tag === "Some") {
+    const result = yield* config2.updateModel({
+      provider: provider.value,
+      model: model.value
+    });
+    console.log(`Updated model configuration:`);
+    console.log(`  Provider: ${result.provider}`);
+    console.log(`  Model: ${result.model}`);
+  } else if (provider._tag === "Some" || model._tag === "Some") {
+    console.error("Error: Both --provider and --model must be specified together");
+    process.exit(1);
+  } else {
+    const current2 = yield* config2.getModel();
+    console.log(`Current model configuration:`);
+    console.log(`  Provider: ${current2.provider}`);
+    console.log(`  Model: ${current2.model}`);
+  }
+}).pipe(exports_Effect.provide(programLayer)));
+var configReposListCommand = exports_Command2.make("list", {}, () => exports_Effect.gen(function* () {
+  const config2 = yield* ConfigService;
+  const repos = yield* config2.getRepos();
+  if (repos.length === 0) {
+    console.log("No repos configured.");
+    return;
+  }
+  console.log(`Configured repos:
+`);
+  for (const repo of repos) {
+    console.log(`  ${repo.name}`);
+    console.log(`    URL: ${repo.url}`);
+    console.log(`    Branch: ${repo.branch}`);
+    if (repo.specialNotes) {
+      console.log(`    Notes: ${repo.specialNotes}`);
+    }
+    console.log();
+  }
 }).pipe(exports_Effect.provide(programLayer)));
+var repoNameOption = exports_Options.text("name").pipe(exports_Options.withAlias("n"));
+var repoUrlOption = exports_Options.text("url").pipe(exports_Options.withAlias("u"));
+var repoBranchOption = exports_Options.text("branch").pipe(exports_Options.withAlias("b"), exports_Options.withDefault("main"));
+var repoNotesOption = exports_Options.text("notes").pipe(exports_Options.optional);
+var configReposAddCommand = exports_Command2.make("add", {
+  name: repoNameOption,
+  url: repoUrlOption,
+  branch: repoBranchOption,
+  notes: repoNotesOption
+}, ({ name, url: url2, branch, notes }) => exports_Effect.gen(function* () {
+  const config2 = yield* ConfigService;
+  const repo = {
+    name,
+    url: url2,
+    branch,
+    ...notes._tag === "Some" ? { specialNotes: notes.value } : {}
+  };
+  yield* config2.addRepo(repo);
+  console.log(`Added repo "${name}":`);
+  console.log(`  URL: ${url2}`);
+  console.log(`  Branch: ${branch}`);
+  if (notes._tag === "Some") {
+    console.log(`  Notes: ${notes.value}`);
+  }
+}).pipe(exports_Effect.catchTag("ConfigError", (e) => exports_Effect.sync(() => {
+  console.error(`Error: ${e.message}`);
+  process.exit(1);
+})), exports_Effect.provide(programLayer)));
+var configReposCommand = exports_Command2.make("repos", {}, () => exports_Effect.sync(() => {
+  console.log("Usage: btca config repos <command>");
+  console.log("");
+  console.log("Commands:");
+  console.log("  list    List all configured repos");
+  console.log("  add     Add a new repo");
+})).pipe(exports_Command2.withSubcommands([configReposListCommand, configReposAddCommand]));
+var configCommand = exports_Command2.make("config", {}, () => exports_Effect.gen(function* () {
+  const config2 = yield* ConfigService;
+  const configPath = yield* config2.getConfigPath();
+  console.log(`Config file: ${configPath}`);
+  console.log("");
+  console.log("Usage: btca config <command>");
+  console.log("");
+  console.log("Commands:");
+  console.log("  model   View or set the model and provider");
+  console.log("  repos   Manage configured repos");
+}).pipe(exports_Effect.provide(programLayer))).pipe(exports_Command2.withSubcommands([configModelCommand, configReposCommand]));
 var mainCommand = exports_Command2.make("btca", {}, () => exports_Effect.sync(() => {
   console.log(`btca v${VERSION}. run btca --help for more information.`);
 })).pipe(exports_Command2.withSubcommands([
@@ -60904,7 +61026,7 @@ var mainCommand = exports_Command2.make("btca", {}, () => exports_Effect.sync(()
   serveCommand,
   openCommand,
   chatCommand,
-  configPathCommand
+  configCommand
 ]));
 var cliService = exports_Effect.gen(function* () {
   return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "btca",
   "author": "Ben Davis",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool for asking questions about technologies using OpenCode",
   "type": "module",
   "license": "MIT",