@obsfx/trekker 1.10.2 → 1.11.0

package/README.md

@@ -31,6 +31,51 @@ Or with npm:
 npm install -g @obsfx/trekker
 ```
 
+## Claude Code Plugin
+
+<img src="https://omercan.io/trekker/images/claude-color.png" width="24" height="24" alt="Claude" style="vertical-align: middle;" />
+
+Install the [trekker-claude-code](https://github.com/obsfx/trekker-claude-code) plugin for seamless integration with [Claude Code](https://claude.ai/code):
+
+```bash
+claude plugin marketplace add obsfx/trekker-claude-code
+claude plugin install trekker
+```
+
+This gives Claude Code native access to Trekker through **26 MCP tools**, **13 slash commands**, **7 skills**, **5 lifecycle hooks**, and an **autonomous task agent**.
+
+**Key features:**
+
+- Persistent task memory across sessions via SQLite
+- Search-first workflow to restore context
+- 7 skills for guided workflows and best practices
+- 5 lifecycle hooks for automatic state management
+- Autonomous task agent for discovery and completion
+- Blocks internal TaskCreate/TodoWrite — enforces Trekker
+- Multi-instance safe with conflict handling
+
+See the [plugin repository](https://github.com/obsfx/trekker-claude-code) for the full list of slash commands, hooks, skills, and agent details.
+
+## Codex Plugin
+
+<img width="36" height="36" alt="OpenAI-black-monoblossom" src="https://github.com/user-attachments/assets/e761c75d-6012-44b0-bfbe-c6cc235b54b4" />
+
+
+Support for the **Codex** plugin is still in a *very early stage* and is continuing to evolve. However, we already have a plugin for **Trekker** that you can install locally. Please follow the [plugin repository](https://github.com/obsfx/trekker-codex) and the instructions at https://developers.openai.com/codex/plugins/build#how-codex-uses-marketplaces, and you can get features similar to those available in the *Claude Code* plugin.
+
+## Web Interface
+
+<img src="https://omercan.io/trekker/images/dashboard-kanban.png" width="480" alt="trekker dashboard" style="vertical-align: middle;" />
+
+For a visual kanban board, install the separate dashboard package:
+
+```bash
+npm install -g @obsfx/trekker-dashboard
+trekker-dashboard -p 3000  # Start dashboard on port 3000
+```
+
+You can find the detail in its [trekker-dashboard](https://github.com/obsfx/trekker-dashboard) repository.
+
 ## Why Trekker
 
 AI coding agents work better when they can track their own progress. A simple CLI-based task manager keeps them on the right path across sessions.
@@ -40,6 +85,7 @@ I built this after using beads for a while. Beads does the job, but its codebase
 My concerns about the future and security of that project led me here. Trekker is my simplified alternative.
 
 What you get:
+
 - Task and epic tracking with dependencies
 - Ready command to find unblocked tasks and see what they unblock
 - Full-text search across tasks, epics, subtasks, and comments
@@ -56,6 +102,8 @@ Initialize Trekker in your project:
 
 ```bash
 trekker init
+# or set custom prefixes up front
+trekker init --issue-prefix FEAT --epic-prefix PLAN --comment-prefix NOTE
 ```
 
 Create an epic for your feature:
@@ -67,16 +115,16 @@ trekker epic create -t "User Authentication" -d "JWT-based auth with login and r
 Add tasks to the epic:
 
 ```bash
-trekker task create -t "Create user model" -e EPIC-1
-trekker task create -t "Build login endpoint" -e EPIC-1
-trekker task create -t "Build registration endpoint" -e EPIC-1
+trekker task create -t "Create user model" -e <epic-id>
+trekker task create -t "Build login endpoint" -e <epic-id>
+trekker task create -t "Build registration endpoint" -e <epic-id>
 ```
 
 Set dependencies between tasks:
 
 ```bash
-trekker dep add TREK-2 TREK-1
-trekker dep add TREK-3 TREK-1
+trekker dep add <task-id> <depends-on-id>
+trekker dep add <task-id> <depends-on-id>
 ```
 
 See what is ready to work on:
@@ -88,8 +136,8 @@ trekker ready
 Update task status as you work:
 
 ```bash
-trekker task update TREK-1 -s in_progress
-trekker task update TREK-1 -s completed
+trekker task update <task-id> -s in_progress
+trekker task update <task-id> -s completed
 ```
 
 ## Commands
@@ -98,10 +146,32 @@ trekker task update TREK-1 -s completed
 
 ```bash
 trekker init              # Initialize in current directory
+trekker init --issue-prefix FEAT --epic-prefix PLAN --comment-prefix NOTE
 trekker wipe              # Delete all data
 trekker quickstart        # Show full documentation
 ```
 
+### Project Config
+
+```bash
+trekker config list
+trekker config get issue_prefix
+trekker config set issue_prefix FEAT
+trekker config set epic_prefix PLAN
+trekker config set comment_prefix NOTE
+trekker config unset issue_prefix
+```
+
+Supported keys:
+
+- `issue_prefix` for tasks and subtasks
+- `epic_prefix` for epics
+- `comment_prefix` for comments
+
+Use `issue_prefix` when you want task IDs to match your project naming scheme. For example, `trekker init --issue-prefix FEAT` starts new task and subtask IDs as `FEAT-1`, `FEAT-2`, and so on. You can also change it later with `trekker config set issue_prefix BUG`, which only affects newly created tasks and subtasks.
+
+Prefix values are normalized to uppercase, must start with a letter, may contain numbers, and must be unique across the three families. Changing a prefix affects only newly created IDs. Existing IDs are never rewritten.
+
 ### Epics
 
 ```bash
@@ -158,6 +228,7 @@ trekker ready [--limit <n>] [--page <n>]
 ```
 
 Example output:
+
 ```
 2 ready task(s):
 
@@ -168,6 +239,7 @@ TREK-4 | P2 | Write docs
 ```
 
 Tasks are sorted by priority (critical first). A task is considered ready when:
+
 - Status is `todo`
 - It is a top-level task (not a subtask)
 - All its dependencies are resolved (`completed`, `wont_fix`, or `archived`)
@@ -181,6 +253,7 @@ trekker search <query> [--type <types>] [--status <status>] [--limit <n>] [--pag
 ```
 
 Examples:
+
 ```bash
 trekker search "authentication"                          # Search all entities
 trekker search "bug fix" --type task,subtask             # Search only tasks and subtasks
@@ -196,9 +269,10 @@ trekker history [--entity <id>] [--type <types>] [--action <actions>] [--since <
 ```
 
 Examples:
+
 ```bash
 trekker history                                  # All events
-trekker history --entity TREK-1                  # Events for specific entity
+trekker history --entity <entity-id>             # Events for specific entity
 trekker history --type task --action update      # Only task updates
 trekker history --since 2025-01-01 --limit 20    # Events after date
 ```
@@ -212,6 +286,7 @@ trekker list [--type <types>] [--status <statuses>] [--priority <levels>] [--sor
 ```
 
 Examples:
+
 ```bash
 trekker list                                     # All items, newest first
 trekker list --type task --status in_progress    # Active tasks only
@@ -219,29 +294,9 @@ trekker list --priority 0,1 --sort priority:asc  # Critical/high priority first
 trekker list --sort title:asc,created:desc       # Sort by title, then by date
 ```
 
-### Web Interface
-
-For a visual kanban board, install the separate dashboard package:
-
-```bash
-npm install -g @obsfx/trekker-dashboard
-trekker-dashboard -p 3000  # Start dashboard on port 3000
-```
 
 The dashboard shows tasks grouped by status and reads from the same `.trekker/trekker.db` database.
-
-## Claude Code Integration
-
-For seamless integration with [Claude Code](https://claude.ai/code), install the Trekker plugin:
-
-```bash
-claude /plugin marketplace add obsfx/trekker-claude-code
-claude /plugin install trekker
-```
-
-This gives Claude Code native access to Trekker commands through MCP. The agent can create tasks, update status, and manage dependencies without running CLI commands directly.
-
-See [trekker-claude-code](https://github.com/obsfx/trekker-claude-code) for more details.
+It also lets you update issue, epic, and comment prefixes from the UI. Those changes affect only newly created IDs.
 
 ## TOON Output
 
@@ -249,7 +304,7 @@ Add the `--toon` flag to any command for structured output in [TOON format](http
 
 ```bash
 trekker --toon task list
-trekker --toon task show TREK-1
+trekker --toon task show <task-id>
 ```
 
 ## Status Values
@@ -267,12 +322,16 @@ Epics: `todo`, `in_progress`, `completed`, `archived`
 - 4: Backlog
 - 5: Someday
 
-## ID Formats
+## ID Prefixes
+
+Default prefixes:
 
 - Epics: `EPIC-1`, `EPIC-2`
-- Tasks: `TREK-1`, `TREK-2`
+- Tasks and subtasks: `TREK-1`, `TREK-2`
 - Comments: `CMT-1`, `CMT-2`
 
+These defaults are project-scoped and configurable through `trekker init --*-prefix` or `trekker config set`. Prefix changes affect only new entities and existing IDs keep their original values.
+
 All list commands default to 50 items per page, sorted by newest first. Use `--limit` and `--page` to paginate through large result sets.
 
 ## Development
@@ -308,6 +367,7 @@ This is my personal workflow for getting the most out of Trekker with AI agents:
 - **Use the dashboard for visibility.** I run [trekker-dashboard](https://github.com/obsfx/trekker-dashboard) to visually track what the agent is doing. It shows tasks on a kanban board and auto-refreshes, so I can monitor progress in real-time.
 
 Example prompt snippet:
+
 ```
 Use trekker to track your work. Run `trekker quickstart` if you need to learn how it works.
 ```

package/dist/index.js

@@ -455,7 +455,7 @@ var require_customParseFormat = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -471,6 +471,7 @@ __export(exports_schema, {
   tasks: () => tasks,
   projectsRelations: () => projectsRelations,
   projects: () => projects,
+  projectConfig: () => projectConfig,
   idCounters: () => idCounters,
   events: () => events,
   epicsRelations: () => epicsRelations,
@@ -488,6 +489,10 @@ var projects = sqliteTable("projects", {
   createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
   updatedAt: integer("updated_at", { mode: "timestamp" }).notNull()
 });
+var projectConfig = sqliteTable("project_config", {
+  key: text("key").primaryKey(),
+  value: text("value").notNull()
+});
 var epics = sqliteTable("epics", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull(),
@@ -590,6 +595,35 @@ var dependenciesRelations = relations(dependencies, ({ one }) => ({
 // src/db/client.ts
 import { existsSync, mkdirSync, rmSync } from "fs";
 import { join } from "path";
+
+// src/types/index.ts
+var TASK_STATUSES = ["todo", "in_progress", "completed", "wont_fix", "archived"];
+var EPIC_STATUSES = ["todo", "in_progress", "completed", "archived"];
+var DEFAULT_PRIORITY = 2;
+var DEFAULT_TASK_STATUS = "todo";
+var DEFAULT_EPIC_STATUS = "todo";
+var PAGINATION_DEFAULTS = {
+  LIST_PAGE_SIZE: 50,
+  SEARCH_PAGE_SIZE: 20,
+  HISTORY_PAGE_SIZE: 50,
+  DEFAULT_PAGE: 1
+};
+var VALID_SORT_FIELDS = ["created", "updated", "title", "priority", "status"];
+var LIST_ENTITY_TYPES = ["epic", "task", "subtask"];
+var SEARCH_ENTITY_TYPES = ["epic", "task", "subtask", "comment"];
+var PROJECT_CONFIG_KEYS = ["issue_prefix", "epic_prefix", "comment_prefix"];
+var PROJECT_CONFIG_DEFAULTS = {
+  issue_prefix: "TREK",
+  epic_prefix: "EPIC",
+  comment_prefix: "CMT"
+};
+var ENTITY_CONFIG_KEY_MAP = {
+  task: "issue_prefix",
+  epic: "epic_prefix",
+  comment: "comment_prefix"
+};
+
+// src/db/client.ts
 var TREKKER_DIR = ".trekker";
 var DB_NAME = "trekker.db";
 function getTrekkerDir(cwd = process.cwd()) {
@@ -621,6 +655,7 @@ function getDb(cwd = process.cwd()) {
   dbInstance = drizzle(sqliteInstance, { schema: exports_schema });
   migrateSearchIndex(sqliteInstance);
   migrateHistoryTable(sqliteInstance);
+  migrateProjectConfigTable(sqliteInstance);
   return dbInstance;
 }
 function createDb(cwd = process.cwd()) {
@@ -636,6 +671,12 @@ function createDb(cwd = process.cwd()) {
       updated_at INTEGER NOT NULL
     )
   `);
+  sqliteInstance.run(`
+    CREATE TABLE IF NOT EXISTS project_config (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    )
+  `);
   sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS epics (
       id TEXT PRIMARY KEY,
@@ -690,6 +731,7 @@ function createDb(cwd = process.cwd()) {
   sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('task', 0)");
   sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('epic', 0)");
   sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('comment', 0)");
+  seedProjectConfig(sqliteInstance);
   sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS events (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -953,6 +995,20 @@ function migrateHistoryTable(sqlite) {
     createHistoryTriggers(sqlite);
   }
 }
+function seedProjectConfig(sqlite) {
+  for (const [key, value] of Object.entries(PROJECT_CONFIG_DEFAULTS)) {
+    sqlite.query("INSERT OR IGNORE INTO project_config (key, value) VALUES (?, ?)").run(key, value);
+  }
+}
+function migrateProjectConfigTable(sqlite) {
+  sqlite.run(`
+    CREATE TABLE IF NOT EXISTS project_config (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    )
+  `);
+  seedProjectConfig(sqlite);
+}
 function rebuildSearchIndex() {
   getDb();
   const sqlite = getSqliteInstance();
@@ -988,35 +1044,106 @@ function deleteDb(cwd = process.cwd()) {
 }
 
 // src/utils/id-generator.ts
-import { eq, sql } from "drizzle-orm";
+import { eq as eq2, sql } from "drizzle-orm";
 
-// src/types/index.ts
-var TASK_STATUSES = ["todo", "in_progress", "completed", "wont_fix", "archived"];
-var EPIC_STATUSES = ["todo", "in_progress", "completed", "archived"];
-var DEFAULT_PRIORITY = 2;
-var DEFAULT_TASK_STATUS = "todo";
-var DEFAULT_EPIC_STATUS = "todo";
-var PAGINATION_DEFAULTS = {
-  LIST_PAGE_SIZE: 50,
-  SEARCH_PAGE_SIZE: 20,
-  HISTORY_PAGE_SIZE: 50,
-  DEFAULT_PAGE: 1
-};
-var VALID_SORT_FIELDS = ["created", "updated", "title", "priority", "status"];
-var LIST_ENTITY_TYPES = ["epic", "task", "subtask"];
-var SEARCH_ENTITY_TYPES = ["epic", "task", "subtask", "comment"];
-var PREFIX_MAP = {
-  task: "TREK",
-  epic: "EPIC",
-  comment: "CMT"
-};
+// src/services/config.ts
+import { eq } from "drizzle-orm";
+var PROJECT_CONFIG_KEY_SET = new Set(PROJECT_CONFIG_KEYS);
+var PREFIX_PATTERN = /^[A-Z][A-Z0-9]*$/;
+function assertProjectConfigKey(key) {
+  if (!PROJECT_CONFIG_KEY_SET.has(key)) {
+    throw new Error(`Unsupported config key: ${key}. Valid keys: ${PROJECT_CONFIG_KEYS.join(", ")}`);
+  }
+}
+function normalizePrefixValue(value) {
+  const normalized = value.trim().toUpperCase();
+  if (!normalized) {
+    throw new Error("Prefix value is required.");
+  }
+  if (!PREFIX_PATTERN.test(normalized)) {
+    throw new Error("Invalid prefix value. Use uppercase letters and numbers only, and start with a letter.");
+  }
+  return normalized;
+}
+function validateUniquePrefixes(config) {
+  const seen = new Map;
+  for (const key of PROJECT_CONFIG_KEYS) {
+    const prefix = config[key];
+    const existingKey = seen.get(prefix);
+    if (existingKey) {
+      throw new Error(`Prefix values must be unique. ${existingKey} and ${key} cannot both use ${prefix}.`);
+    }
+    seen.set(prefix, key);
+  }
+}
+function resolveProjectConfig(updates, baseConfig = PROJECT_CONFIG_DEFAULTS) {
+  const normalizedUpdates = {};
+  if (updates) {
+    for (const rawKey of PROJECT_CONFIG_KEYS) {
+      const rawValue = updates[rawKey];
+      if (rawValue === undefined) {
+        continue;
+      }
+      normalizedUpdates[rawKey] = normalizePrefixValue(rawValue);
+    }
+  }
+  const nextConfig = {
+    ...baseConfig,
+    ...normalizedUpdates
+  };
+  validateUniquePrefixes(nextConfig);
+  return nextConfig;
+}
+function listProjectConfig() {
+  const db = getDb();
+  const rows = db.select().from(projectConfig).all();
+  const config = { ...PROJECT_CONFIG_DEFAULTS };
+  for (const row of rows) {
+    if (!PROJECT_CONFIG_KEY_SET.has(row.key)) {
+      continue;
+    }
+    assertProjectConfigKey(row.key);
+    config[row.key] = row.value;
+  }
+  return config;
+}
+function listProjectConfigEntries() {
+  const config = listProjectConfig();
+  return PROJECT_CONFIG_KEYS.map((key) => ({ key, value: config[key] }));
+}
+function getProjectConfigValue(key) {
+  return listProjectConfig()[key];
+}
+function upsertProjectConfigValue(key, value) {
+  const db = getDb();
+  const existing = db.select().from(projectConfig).where(eq(projectConfig.key, key)).get();
+  if (existing) {
+    db.update(projectConfig).set({ value }).where(eq(projectConfig.key, key)).run();
+    return;
+  }
+  db.insert(projectConfig).values({ key, value }).run();
+}
+function setProjectConfigValues(updates) {
+  const currentConfig = listProjectConfig();
+  const nextConfig = resolveProjectConfig(updates, currentConfig);
+  for (const key of PROJECT_CONFIG_KEYS) {
+    const nextValue = nextConfig[key];
+    if (nextValue !== currentConfig[key]) {
+      upsertProjectConfigValue(key, nextValue);
+    }
+  }
+  return nextConfig;
+}
+function unsetProjectConfigValue(key) {
+  return setProjectConfigValues({ [key]: PROJECT_CONFIG_DEFAULTS[key] })[key];
+}
 
 // src/utils/id-generator.ts
 function generateId(entityType) {
   const db = getDb();
-  const prefix = PREFIX_MAP[entityType];
-  db.update(idCounters).set({ counter: sql`${idCounters.counter} + 1` }).where(eq(idCounters.entityType, entityType)).run();
-  const result = db.select({ counter: idCounters.counter }).from(idCounters).where(eq(idCounters.entityType, entityType)).get();
+  const prefix = getProjectConfigValue(ENTITY_CONFIG_KEY_MAP[entityType]);
+  db.update(idCounters).set({ counter: sql`${idCounters.counter} + 1` }).where(eq2(idCounters.entityType, entityType)).run();
+  const result = db.select({ counter: idCounters.counter }).from(idCounters).where(eq2(idCounters.entityType, entityType)).get();
   if (!result) {
     throw new Error(`Counter not found for entity type: ${entityType}`);
   }
@@ -1028,10 +1155,13 @@ function generateUuid() {
 
 // src/services/project.ts
 import { basename } from "path";
-function initProject(cwd = process.cwd()) {
+function initProject(cwd = process.cwd(), configOverrides) {
   if (isTrekkerInitialized(cwd)) {
     throw new Error("Trekker is already initialized in this directory.");
   }
+  if (configOverrides) {
+    resolveProjectConfig(configOverrides);
+  }
   const db = createDb(cwd);
   const projectName = basename(cwd);
   const now = new Date;
@@ -1041,6 +1171,9 @@ function initProject(cwd = process.cwd()) {
     createdAt: now,
     updatedAt: now
   }).run();
+  if (configOverrides) {
+    setProjectConfigValues(configOverrides);
+  }
 }
 function wipeProject(cwd = process.cwd()) {
   if (!isTrekkerInitialized(cwd)) {
@@ -1734,15 +1867,26 @@ function formatPaginatedCommentList(result) {
   return lines.join(`
 `);
 }
+function formatProjectConfigList(entries) {
+  if (entries.length === 0) {
+    return "No config values found.";
+  }
+  return entries.map((entry) => `${entry.key}=${entry.value}`).join(`
+`);
+}
 
 // src/commands/init.ts
-var initCommand = new Command("init").description("Initialize Trekker in the current directory").action(() => {
+var initCommand = new Command("init").description("Initialize Trekker in the current directory").option("--issue-prefix <value>", "Prefix for tasks and subtasks (default: TREK)").option("--epic-prefix <value>", "Prefix for epics (default: EPIC)").option("--comment-prefix <value>", "Prefix for comments (default: CMT)").action((options) => {
   try {
     if (isTrekkerInitialized()) {
       error("Trekker is already initialized in this directory.");
       process.exit(1);
     }
-    initProject();
+    initProject(process.cwd(), {
+      issue_prefix: options.issuePrefix,
+      epic_prefix: options.epicPrefix,
+      comment_prefix: options.commentPrefix
+    });
     success("Trekker initialized successfully.");
   } catch (err) {
     handleCommandError(err);
@@ -1788,7 +1932,7 @@ function confirm(prompt) {
 import { Command as Command3 } from "commander";
 
 // src/services/epic.ts
-import { eq as eq2, and, isNull, desc, sql as sql2 } from "drizzle-orm";
+import { eq as eq3, and, isNull, desc, sql as sql2 } from "drizzle-orm";
 function createEpic(input) {
   const db = getDb();
   const project = db.select().from(projects).get();
@@ -1812,7 +1956,7 @@ function createEpic(input) {
 }
 function getEpic(id) {
   const db = getDb();
-  return db.select().from(epics).where(eq2(epics.id, id)).get();
+  return db.select().from(epics).where(eq3(epics.id, id)).get();
 }
 function listEpics(options) {
   const db = getDb();
@@ -1821,7 +1965,7 @@ function listEpics(options) {
   const offset = (page - 1) * limit;
   let where;
   if (options?.status) {
-    where = eq2(epics.status, options.status);
+    where = eq3(epics.status, options.status);
   }
   const countRow = db.select({ count: sql2`count(*)` }).from(epics).where(where).get();
   const total = countRow?.count ?? 0;
@@ -1849,7 +1993,7 @@ function updateEpic(id, input) {
   if (input.priority !== undefined) {
     updates.priority = input.priority;
   }
-  db.update(epics).set(updates).where(eq2(epics.id, id)).run();
+  db.update(epics).set(updates).where(eq3(epics.id, id)).run();
   const updated = getEpic(id);
   if (!updated) {
     throw new Error(`Epic not found after update: ${id}`);
@@ -1862,7 +2006,7 @@ function deleteEpic(id) {
   if (!existing) {
     throw new Error(`Epic not found: ${id}`);
   }
-  db.delete(epics).where(eq2(epics.id, id)).run();
+  db.delete(epics).where(eq3(epics.id, id)).run();
 }
 function completeEpic(id) {
   const db = getDb();
@@ -1873,20 +2017,20 @@ function completeEpic(id) {
   if (existing.status === "completed") {
     throw new Error(`Epic is already completed: ${id}`);
   }
-  const epicTasks = db.select().from(tasks).where(and(eq2(tasks.epicId, id), isNull(tasks.parentTaskId))).all();
+  const epicTasks = db.select().from(tasks).where(and(eq3(tasks.epicId, id), isNull(tasks.parentTaskId))).all();
   const taskIds = epicTasks.map((t) => t.id);
   let subtaskCount = 0;
   if (taskIds.length > 0) {
     for (const taskId of taskIds) {
-      const subtasks = db.select().from(tasks).where(eq2(tasks.parentTaskId, taskId)).all();
+      const subtasks = db.select().from(tasks).where(eq3(tasks.parentTaskId, taskId)).all();
       subtaskCount += subtasks.length;
       if (subtasks.length > 0) {
-        db.update(tasks).set({ status: "archived", updatedAt: new Date }).where(eq2(tasks.parentTaskId, taskId)).run();
+        db.update(tasks).set({ status: "archived", updatedAt: new Date }).where(eq3(tasks.parentTaskId, taskId)).run();
       }
     }
-    db.update(tasks).set({ status: "archived", updatedAt: new Date }).where(and(eq2(tasks.epicId, id), isNull(tasks.parentTaskId))).run();
+    db.update(tasks).set({ status: "archived", updatedAt: new Date }).where(and(eq3(tasks.epicId, id), isNull(tasks.parentTaskId))).run();
   }
-  db.update(epics).set({ status: "completed", updatedAt: new Date }).where(eq2(epics.id, id)).run();
+  db.update(epics).set({ status: "completed", updatedAt: new Date }).where(eq3(epics.id, id)).run();
   return {
     epic: id,
     status: "completed",
@@ -2082,7 +2226,7 @@ epicCommand.command("complete <epic-id>").description("Complete an epic and arch
 import { Command as Command4 } from "commander";
 
 // src/services/task.ts
-import { eq as eq3, and as and2, isNull as isNull2, desc as desc2, sql as sql3 } from "drizzle-orm";
+import { eq as eq4, and as and2, isNull as isNull2, desc as desc2, sql as sql3 } from "drizzle-orm";
 function createTask(input) {
   const db = getDb();
   const project = db.select().from(projects).get();
@@ -2090,13 +2234,13 @@ function createTask(input) {
     throw new Error("Project not found. Run 'trekker init' first.");
   }
   if (input.epicId) {
-    const epic = db.select().from(epics).where(eq3(epics.id, input.epicId)).get();
+    const epic = db.select().from(epics).where(eq4(epics.id, input.epicId)).get();
     if (!epic) {
       throw new Error(`Epic not found: ${input.epicId}`);
     }
   }
   if (input.parentTaskId) {
-    const parent = db.select().from(tasks).where(eq3(tasks.id, input.parentTaskId)).get();
+    const parent = db.select().from(tasks).where(eq4(tasks.id, input.parentTaskId)).get();
     if (!parent) {
       throw new Error(`Parent task not found: ${input.parentTaskId}`);
     }
@@ -2121,7 +2265,7 @@ function createTask(input) {
 }
 function getTask(id) {
   const db = getDb();
-  return db.select().from(tasks).where(eq3(tasks.id, id)).get();
+  return db.select().from(tasks).where(eq4(tasks.id, id)).get();
 }
 function listTasks(options) {
   const db = getDb();
@@ -2130,15 +2274,15 @@ function listTasks(options) {
   const offset = (page - 1) * limit;
   const conditions = [];
   if (options?.status) {
-    conditions.push(eq3(tasks.status, options.status));
+    conditions.push(eq4(tasks.status, options.status));
   }
   if (options?.epicId) {
-    conditions.push(eq3(tasks.epicId, options.epicId));
+    conditions.push(eq4(tasks.epicId, options.epicId));
   }
   if (options?.parentTaskId === null) {
     conditions.push(isNull2(tasks.parentTaskId));
   } else if (options?.parentTaskId) {
-    conditions.push(eq3(tasks.parentTaskId, options.parentTaskId));
+    conditions.push(eq4(tasks.parentTaskId, options.parentTaskId));
   }
   let where;
   if (conditions.length > 0) {
@@ -2154,7 +2298,7 @@ function listSubtasks(parentTaskId, options) {
   const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
   const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
   const offset = (page - 1) * limit;
-  const where = eq3(tasks.parentTaskId, parentTaskId);
+  const where = eq4(tasks.parentTaskId, parentTaskId);
   const countRow = db.select({ count: sql3`count(*)` }).from(tasks).where(where).get();
   const total = countRow?.count ?? 0;
   const items = db.select().from(tasks).where(where).orderBy(desc2(tasks.createdAt)).limit(limit).offset(offset).all();
@@ -2167,7 +2311,7 @@ function updateTask(id, input) {
     throw new Error(`Task not found: ${id}`);
   }
   if (input.epicId) {
-    const epic = db.select().from(epics).where(eq3(epics.id, input.epicId)).get();
+    const epic = db.select().from(epics).where(eq4(epics.id, input.epicId)).get();
     if (!epic) {
       throw new Error(`Epic not found: ${input.epicId}`);
     }
@@ -2193,7 +2337,7 @@ function updateTask(id, input) {
   if (input.epicId !== undefined) {
     updates.epicId = input.epicId;
   }
-  db.update(tasks).set(updates).where(eq3(tasks.id, id)).run();
+  db.update(tasks).set(updates).where(eq4(tasks.id, id)).run();
   const updated = getTask(id);
   if (!updated) {
     throw new Error(`Task not found after update: ${id}`);
@@ -2206,7 +2350,7 @@ function deleteTask(id) {
   if (!existing) {
     throw new Error(`Task not found: ${id}`);
   }
-  db.delete(tasks).where(eq3(tasks.id, id)).run();
+  db.delete(tasks).where(eq4(tasks.id, id)).run();
 }
 
 // src/commands/task.ts
@@ -2378,10 +2522,10 @@ subtaskCommand.command("delete <subtask-id>").description("Delete a subtask").ac
 import { Command as Command6 } from "commander";
 
 // src/services/comment.ts
-import { eq as eq4, desc as desc3, sql as sql4 } from "drizzle-orm";
+import { eq as eq5, desc as desc3, sql as sql4 } from "drizzle-orm";
 function createComment(input) {
   const db = getDb();
-  const task = db.select().from(tasks).where(eq4(tasks.id, input.taskId)).get();
+  const task = db.select().from(tasks).where(eq5(tasks.id, input.taskId)).get();
   if (!task) {
     throw new Error(`Task not found: ${input.taskId}`);
   }
@@ -2400,18 +2544,18 @@ function createComment(input) {
 }
 function getComment(id) {
   const db = getDb();
-  return db.select().from(comments).where(eq4(comments.id, id)).get();
+  return db.select().from(comments).where(eq5(comments.id, id)).get();
 }
 function listComments(taskId, options) {
   const db = getDb();
   const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
   const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
   const offset = (page - 1) * limit;
-  const task = db.select().from(tasks).where(eq4(tasks.id, taskId)).get();
+  const task = db.select().from(tasks).where(eq5(tasks.id, taskId)).get();
   if (!task) {
     throw new Error(`Task not found: ${taskId}`);
   }
-  const where = eq4(comments.taskId, taskId);
+  const where = eq5(comments.taskId, taskId);
   const countRow = db.select({ count: sql4`count(*)` }).from(comments).where(where).get();
   const total = countRow?.count ?? 0;
   const items = db.select().from(comments).where(where).orderBy(desc3(comments.createdAt)).limit(limit).offset(offset).all();
@@ -2426,7 +2570,7 @@ function updateComment(id, input) {
   db.update(comments).set({
     content: input.content,
     updatedAt: new Date
-  }).where(eq4(comments.id, id)).run();
+  }).where(eq5(comments.id, id)).run();
   const updated = getComment(id);
   if (!updated) {
     throw new Error(`Comment not found after update: ${id}`);
@@ -2439,7 +2583,7 @@ function deleteComment(id) {
   if (!existing) {
     throw new Error(`Comment not found: ${id}`);
   }
-  db.delete(comments).where(eq4(comments.id, id)).run();
+  db.delete(comments).where(eq5(comments.id, id)).run();
 }
 
 // src/commands/comment.ts
@@ -2491,21 +2635,21 @@ commentCommand.command("delete <comment-id>").description("Delete a comment").ac
 import { Command as Command7 } from "commander";
 
 // src/services/dependency.ts
-import { eq as eq5 } from "drizzle-orm";
+import { eq as eq6 } from "drizzle-orm";
 function addDependency(taskId, dependsOnId) {
   const db = getDb();
-  const task = db.select().from(tasks).where(eq5(tasks.id, taskId)).get();
+  const task = db.select().from(tasks).where(eq6(tasks.id, taskId)).get();
   if (!task) {
     throw new Error(`Task not found: ${taskId}`);
   }
-  const dependsOnTask = db.select().from(tasks).where(eq5(tasks.id, dependsOnId)).get();
+  const dependsOnTask = db.select().from(tasks).where(eq6(tasks.id, dependsOnId)).get();
   if (!dependsOnTask) {
     throw new Error(`Task not found: ${dependsOnId}`);
   }
   if (taskId === dependsOnId) {
     throw new Error("A task cannot depend on itself.");
   }
-  const existing = db.select().from(dependencies).where(eq5(dependencies.taskId, taskId)).all().find((d) => d.dependsOnId === dependsOnId);
+  const existing = db.select().from(dependencies).where(eq6(dependencies.taskId, taskId)).all().find((d) => d.dependsOnId === dependsOnId);
   if (existing) {
     throw new Error(`Dependency already exists: ${taskId} \u2192 ${dependsOnId}`);
   }
@@ -2525,22 +2669,22 @@ function addDependency(taskId, dependsOnId) {
 }
 function removeDependency(taskId, dependsOnId) {
   const db = getDb();
-  const existing = db.select().from(dependencies).where(eq5(dependencies.taskId, taskId)).all().find((d) => d.dependsOnId === dependsOnId);
+  const existing = db.select().from(dependencies).where(eq6(dependencies.taskId, taskId)).all().find((d) => d.dependsOnId === dependsOnId);
   if (!existing) {
     throw new Error(`Dependency not found: ${taskId} \u2192 ${dependsOnId}`);
   }
-  db.delete(dependencies).where(eq5(dependencies.id, existing.id)).run();
+  db.delete(dependencies).where(eq6(dependencies.id, existing.id)).run();
 }
 function getDependencies(taskId) {
   const db = getDb();
   const dependsOn = db.select({
     taskId: dependencies.taskId,
     dependsOnId: dependencies.dependsOnId
-  }).from(dependencies).where(eq5(dependencies.taskId, taskId)).all();
+  }).from(dependencies).where(eq6(dependencies.taskId, taskId)).all();
   const blocks = db.select({
     taskId: dependencies.taskId,
     dependsOnId: dependencies.dependsOnId
-  }).from(dependencies).where(eq5(dependencies.dependsOnId, taskId)).all();
+  }).from(dependencies).where(eq6(dependencies.dependsOnId, taskId)).all();
   return { dependsOn, blocks };
 }
 function wouldCreateCycle(taskId, dependsOnId) {
@@ -2559,7 +2703,7 @@ function wouldCreateCycle(taskId, dependsOnId) {
       continue;
     }
     visited.add(current);
-    const deps = db.select({ dependsOnId: dependencies.dependsOnId }).from(dependencies).where(eq5(dependencies.taskId, current)).all();
+    const deps = db.select({ dependsOnId: dependencies.dependsOnId }).from(dependencies).where(eq6(dependencies.taskId, current)).all();
     for (const dep of deps) {
       if (!visited.has(dep.dependsOnId)) {
         stack.push(dep.dependsOnId);
@@ -2624,7 +2768,7 @@ trekker wipe -y                 # Remove all data
 1. Set status to \`in_progress\` when starting, \`completed\` when done
 2. Add summary comment before marking task complete
 3. Use \`--toon\` flag for token-efficient output
-4. When epic is done, use \`trekker epic complete EPIC-n\` to archive all tasks
+4. When an epic is done, use \`trekker epic complete <epic-id>\` to archive all tasks
 5. Write detailed descriptions with implementation plans - future agents need this context
 6. Comments are your external memory - add summaries before context resets
 
@@ -2633,41 +2777,47 @@ trekker wipe -y                 # Remove all data
 ### Epics (features/milestones)
 trekker epic create -t "Title" [-d "desc"] [-p 0-5]
 trekker epic list [--status <status>]
-trekker epic show EPIC-1
-trekker epic update EPIC-1 [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>]
-trekker epic complete EPIC-1   # Complete and archive all tasks
-trekker epic delete EPIC-1
+trekker epic show <epic-id>
+trekker epic update <epic-id> [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>]
+trekker epic complete <epic-id>   # Complete and archive all tasks
+trekker epic delete <epic-id>
 
 ### Tasks
-trekker task create -t "Title" [-d "desc"] [-p 0-5] [-e EPIC-1] [--tags "a,b"]
-trekker task list [--status <status>] [--epic EPIC-1]
-trekker task show TREK-1
-trekker task update TREK-1 [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>] [--tags "a,b"] [-e EPIC-1] [--no-epic]
-trekker task delete TREK-1
+trekker task create -t "Title" [-d "desc"] [-p 0-5] [-e <epic-id>] [--tags "a,b"]
+trekker task list [--status <status>] [--epic <epic-id>]
+trekker task show <task-id>
+trekker task update <task-id> [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>] [--tags "a,b"] [-e <epic-id>] [--no-epic]
+trekker task delete <task-id>
 
 ### Subtasks
-trekker subtask create TREK-1 -t "Title" [-d "desc"] [-p 0-5]
-trekker subtask list TREK-1
-trekker subtask update TREK-2 [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>]
-trekker subtask delete TREK-2
+trekker subtask create <task-id> -t "Title" [-d "desc"] [-p 0-5]
+trekker subtask list <task-id>
+trekker subtask update <subtask-id> [-t "Title"] [-d "desc"] [-p 0-5] [-s <status>]
+trekker subtask delete <subtask-id>
 
 ### Comments (external memory)
-trekker comment add TREK-1 -a "agent" -c "content"
-trekker comment list TREK-1
-trekker comment update CMT-1 -c "new content"
-trekker comment delete CMT-1
+trekker comment add <task-id> -a "agent" -c "content"
+trekker comment list <task-id>
+trekker comment update <comment-id> -c "new content"
+trekker comment delete <comment-id>
 
 ### Dependencies
-trekker dep add TREK-2 TREK-1   # TREK-2 depends on TREK-1
-trekker dep remove TREK-2 TREK-1
-trekker dep list TREK-1
+trekker dep add <task-id> <depends-on-id>
+trekker dep remove <task-id> <depends-on-id>
+trekker dep list <task-id>
+
+### Project Config
+trekker config list
+trekker config get issue_prefix
+trekker config set issue_prefix ABC
+trekker config unset issue_prefix
 
 ### Search (full-text across all entities)
 trekker search "query" [--type epic,task,subtask,comment] [--status <status>]
 trekker search "auth bug" --type task --limit 10
 
 ### History (audit log of all changes)
-trekker history [--entity TREK-1] [--type task] [--action create,update,delete]
+trekker history [--entity <entity-id>] [--type task] [--action create,update,delete]
 trekker history --since 2025-01-01 --limit 20
 
 ### List (unified view of all items)
@@ -2706,17 +2856,17 @@ flowchart TD
 
 ## Session Start
 trekker --toon task list --status in_progress
-trekker --toon comment list TREK-1
+trekker --toon comment list <task-id>
 
 ## Working
-trekker task update TREK-1 -s in_progress
-trekker comment add TREK-1 -a "agent" -c "Analysis: ..."
+trekker task update <task-id> -s in_progress
+trekker comment add <task-id> -a "agent" -c "Analysis: ..."
 # ... do work ...
-trekker comment add TREK-1 -a "agent" -c "Summary: implemented X in files A, B"
-trekker task update TREK-1 -s completed
+trekker comment add <task-id> -a "agent" -c "Summary: implemented X in files A, B"
+trekker task update <task-id> -s completed
 
 ## Before Context Reset
-trekker comment add TREK-1 -a "agent" -c "Checkpoint: done A,B. Next: C. Files: x.ts, y.ts"
+trekker comment add <task-id> -a "agent" -c "Checkpoint: done A,B. Next: C. Files: x.ts, y.ts"
 
 ## Writing Effective Descriptions
 
@@ -3228,7 +3378,7 @@ function getHistory(options) {
 
 // src/commands/history.ts
 import_dayjs.default.extend(import_customParseFormat.default);
-var historyCommand = new Command11("history").description("View history of all changes (creates, updates, deletes)").option("--entity <id>", "Filter by entity ID (e.g., TREK-1, EPIC-1)").option("--type <types>", "Filter by type: epic,task,subtask,comment,dependency (comma-separated)").option("--action <actions>", "Filter by action: create,update,delete (comma-separated)").option("--since <date>", "Events after date (YYYY-MM-DD)").option("--until <date>", "Events before date (YYYY-MM-DD)").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
+var historyCommand = new Command11("history").description("View history of all changes (creates, updates, deletes)").option("--entity <id>", "Filter by entity ID").option("--type <types>", "Filter by type: epic,task,subtask,comment,dependency (comma-separated)").option("--action <actions>", "Filter by action: create,update,delete (comma-separated)").option("--since <date>", "Events after date (YYYY-MM-DD)").option("--until <date>", "Events before date (YYYY-MM-DD)").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
   try {
     const types = parseCommaSeparated(options.type);
     const actions = parseCommaSeparated(options.action);
@@ -3651,10 +3801,56 @@ Page ${result.page} of ${totalPages}`);
   return lines.join(`
 `);
 }
+
+// src/commands/config.ts
+import { Command as Command14 } from "commander";
+var configCommand = new Command14("config").description("Manage project configuration");
+configCommand.command("list").description("List supported project config values").action(() => {
+  try {
+    if (isToonMode()) {
+      output(listProjectConfig());
+      return;
+    }
+    outputResult(listProjectConfigEntries(), formatProjectConfigList);
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
+configCommand.command("get <key>").description("Get a project config value").action((key) => {
+  try {
+    assertProjectConfigKey(key);
+    const value = getProjectConfigValue(key);
+    if (isToonMode()) {
+      output({ key, value });
+      return;
+    }
+    console.log(value);
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
+configCommand.command("set <key> <value>").description("Set a project config value").action((key, value) => {
+  try {
+    assertProjectConfigKey(key);
+    const config = setProjectConfigValues({ [key]: value });
+    success(`Config updated: ${key}=${config[key]}`, { key, value: config[key] });
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
+configCommand.command("unset <key>").description("Reset a project config value to its default").action((key) => {
+  try {
+    assertProjectConfigKey(key);
+    const value = unsetProjectConfigValue(key);
+    success(`Config reset: ${key}=${value}`, { key, value });
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
 // package.json
 var package_default = {
   name: "@obsfx/trekker",
-  version: "1.10.2",
+  version: "1.11.0",
   description: "A CLI-based issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database.",
   type: "module",
   main: "dist/index.js",
@@ -3708,26 +3904,26 @@ var package_default = {
     bun: ">=1.0.0"
   },
   dependencies: {
-    "@toon-format/toon": "^2.1.0",
-    commander: "^13.1.0",
-    dayjs: "^1.11.19",
-    "drizzle-orm": "^0.38.4"
+    "@toon-format/toon": "2.1.0",
+    commander: "13.1.0",
+    dayjs: "1.11.19",
+    "drizzle-orm": "0.38.4"
   },
   devDependencies: {
-    "@types/bun": "^1.2.2",
-    "drizzle-kit": "^0.30.4",
-    eslint: "^10.0.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^63.0.0",
-    knip: "^5.85.0",
-    prettier: "^3.8.1",
-    typescript: "^5.7.3",
-    "typescript-eslint": "^8.56.1"
+    "@types/bun": "1.2.2",
+    "drizzle-kit": "0.30.4",
+    eslint: "10.0.2",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-unicorn": "63.0.0",
+    knip: "6.3.1",
+    prettier: "3.8.1",
+    typescript: "5.7.3",
+    "typescript-eslint": "8.56.1"
   }
 };
 
 // src/index.ts
-var program = new Command14;
+var program = new Command15;
 program.name("trekker").description("CLI-based issue tracker for coding agents").version(package_default.version).option("--toon", "Output in TOON format").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.toon) {
@@ -3747,4 +3943,5 @@ program.addCommand(searchCommand);
 program.addCommand(historyCommand);
 program.addCommand(listCommand);
 program.addCommand(readyCommand);
+program.addCommand(configCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@obsfx/trekker",
-  "version": "1.10.2",
+  "version": "1.11.0",
   "description": "A CLI-based issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database.",
   "type": "module",
   "main": "dist/index.js",
@@ -54,20 +54,20 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@toon-format/toon": "^2.1.0",
-    "commander": "^13.1.0",
-    "dayjs": "^1.11.19",
-    "drizzle-orm": "^0.38.4"
+    "@toon-format/toon": "2.1.0",
+    "commander": "13.1.0",
+    "dayjs": "1.11.19",
+    "drizzle-orm": "0.38.4"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.2",
-    "drizzle-kit": "^0.30.4",
-    "eslint": "^10.0.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^63.0.0",
-    "knip": "^5.85.0",
-    "prettier": "^3.8.1",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.56.1"
+    "@types/bun": "1.2.2",
+    "drizzle-kit": "0.30.4",
+    "eslint": "10.0.2",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-unicorn": "63.0.0",
+    "knip": "6.3.1",
+    "prettier": "3.8.1",
+    "typescript": "5.7.3",
+    "typescript-eslint": "8.56.1"
   }
 }