botholomew 0.8.3 → 0.8.4

package/README.md

@@ -8,15 +8,17 @@
 
 ![Botholomew chat TUI](docs/assets/chat-happy-path.gif)
 
-**A local AI agent for knowledge work.** Botholomew is an autonomous agent
+**An AI agent for knowledge work.** Botholomew is an autonomous agent
 that works its way through a task queue — reading email, summarizing
 documents, researching topics, organizing notes, and maintaining context
 over time — while you sleep, work, or chat with it.
 
-Unlike coding agents, Botholomew has **no shell, no filesystem, and no network
-tools** by default. Everything it touches lives inside a single DuckDB database
-at `.botholomew/data.duckdb` and a handful of markdown files. External access
-is granted deliberately, per project, through MCP servers.
+Unlike coding agents, Botholomew has **no shell and no direct access to
+your filesystem**. It can't edit files on disk — instead, it ingests local
+files, folders, and URLs into a DuckDB-backed context store that it can
+read, search, and summarize. External capabilities (email, Slack, the web,
+and hundreds of other services) are granted deliberately, per project,
+through MCP servers wired up via [MCPX](https://github.com/evantahler/mcpx).
 
 ---
 
@@ -27,19 +29,19 @@ is granted deliberately, per project, through MCP servers.
   long-running `--persist` worker, or point cron at `botholomew worker run`.
 - **Portable.** Each project is a `.botholomew/` directory — markdown +
   DuckDB. Copy it, share it, check it in (or `.gitignore` it).
-- **Local.** All data stays on your machine. Embeddings are indexed in
-  DuckDB's native vector store with HNSW. Model calls go direct to Anthropic
-  and OpenAI.
+- **Your data, your disk.** Project state — tasks, threads, ingested
+  context, embeddings — lives in `.botholomew/`, indexed in DuckDB with
+  HNSW for vector search. Model calls go direct to Anthropic and OpenAI;
+  any further reach is scoped to the MCP servers you add.
 - **Extensible.** External tools come from MCP servers via
   [MCPX](https://github.com/evantahler/mcpx) — run them locally (Gmail,
   Slack, GitHub) or connect through an MCP gateway like
   [Arcade.dev](https://www.arcade.dev/) to reach hundreds of
   authenticated services without managing each server yourself.
   Reusable workflows are defined as markdown "skills" (slash commands).
-- **Safe by default.** The agent has no shell, no network, and no
-  filesystem access of its own. Everything it can touch lives in
-  `.botholomew/` — and every external capability is something you
-  explicitly add.
+- **Safe by default.** The agent has no shell and no direct filesystem
+  access. Out of the box, everything it can touch lives in `.botholomew/`;
+  every external capability is a MCP server you explicitly add.
 - **Concurrent.** Many workers can run at once. Each registers itself in
   the DB and heartbeats; crashed workers get reaped and their tasks go
   back into the queue automatically.
@@ -49,6 +51,15 @@ is granted deliberately, per project, through MCP servers.
 
 ---
 
+## Demo
+
+A full tour of the chat TUI — every tab, slash-command autocomplete,
+the message queue, tool-call visualization, and the live workers panel:
+
+![Tour of every tab in the chat TUI](docs/assets/full-tour.gif)
+
+---
+
 ## Install
 
 Requires [Bun](https://bun.sh) 1.1+.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "botholomew",
-  "version": "0.8.3",
-  "description": "Local, autonomous AI agent for knowledge work — works your task queue while you sleep.",
+  "version": "0.8.4",
+  "description": "An autonomous AI agent for knowledge work — works your task queue while you sleep.",
   "type": "module",
   "bin": {
     "botholomew": "./src/cli.ts"

package/src/config/loader.ts

@@ -1,4 +1,5 @@
 import { getConfigPath } from "../constants.ts";
+import { setLogLevel } from "../utils/logger.ts";
 import { type BotholomewConfig, DEFAULT_CONFIG } from "./schemas.ts";
 
 export async function loadConfig(
@@ -22,6 +23,8 @@ export async function loadConfig(
     config.openai_api_key = process.env.OPENAI_API_KEY;
   }
 
+  setLogLevel(config.log_level);
+
   return config;
 }
 

package/src/config/schemas.ts

@@ -15,6 +15,7 @@ export interface BotholomewConfig {
   worker_stopped_retention_seconds?: number;
   schedule_min_interval_seconds?: number;
   schedule_claim_stale_seconds?: number;
+  log_level?: string;
 }
 
 export const DEFAULT_CONFIG: Required<BotholomewConfig> = {
@@ -34,4 +35,5 @@ export const DEFAULT_CONFIG: Required<BotholomewConfig> = {
   worker_stopped_retention_seconds: 3600,
   schedule_min_interval_seconds: 60,
   schedule_claim_stale_seconds: 300,
+  log_level: "",
 };

package/src/utils/logger.ts

@@ -4,34 +4,78 @@ function ts(): string {
   return ansis.gray(new Date().toTimeString().slice(0, 8));
 }
 
+const LEVELS = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4,
+} as const;
+
+type LogLevel = keyof typeof LEVELS;
+
+function parseLevel(raw: string | undefined): number | undefined {
+  const key = raw?.toLowerCase();
+  if (key && key in LEVELS) return LEVELS[key as LogLevel];
+  return undefined;
+}
+
+const envPinned = parseLevel(process.env.BOTHOLOMEW_LOG_LEVEL) !== undefined;
+
+function defaultLevel(): number {
+  const explicit = parseLevel(process.env.BOTHOLOMEW_LOG_LEVEL);
+  if (explicit !== undefined) return explicit;
+  if (process.env.NODE_ENV === "test") return LEVELS.error;
+  return LEVELS.info;
+}
+
+let currentLevel = defaultLevel();
+
+/**
+ * Apply a log level from config. `BOTHOLOMEW_LOG_LEVEL` always wins, so
+ * this is a no-op when that env var is set. Empty/invalid values are
+ * ignored — callers can pass `config.log_level` directly without checking.
+ */
+export function setLogLevel(level: string | undefined): void {
+  if (envPinned) return;
+  const parsed = parseLevel(level);
+  if (parsed === undefined) return;
+  currentLevel = parsed;
+}
+
 export const logger = {
   info(msg: string) {
+    if (currentLevel < LEVELS.info) return;
     console.log(ts(), ansis.blue("ℹ"), msg);
   },
 
   success(msg: string) {
+    if (currentLevel < LEVELS.info) return;
     console.log(ts(), ansis.green("✓"), msg);
   },
 
   warn(msg: string) {
+    if (currentLevel < LEVELS.warn) return;
     console.log(ts(), ansis.yellow("⚠"), msg);
   },
 
   error(msg: string) {
+    if (currentLevel < LEVELS.error) return;
     console.error(ts(), ansis.red("✗"), msg);
   },
 
   debug(msg: string) {
-    if (process.env.BOTHOLOMEW_DEBUG) {
-      console.log(ts(), ansis.gray("·"), ansis.gray(msg));
-    }
+    if (currentLevel < LEVELS.debug) return;
+    console.log(ts(), ansis.gray("·"), ansis.gray(msg));
   },
 
   dim(msg: string) {
+    if (currentLevel < LEVELS.info) return;
     console.log(ts(), ansis.dim(msg));
   },
 
   phase(name: string, detail?: string) {
+    if (currentLevel < LEVELS.info) return;
     const tag = ansis.magenta.bold(`[[${name}]]`);
     if (detail) {
       console.log(ts(), tag, ansis.dim(detail));