opencode-add-dir 1.3.0 → 1.4.0

package/README.md

@@ -31,7 +31,6 @@ Automatically adds the plugin to your global `opencode.json`.
 <summary>Alternative: local file</summary>
 
 ```bash
-# Clone and build
 git clone https://github.com/kuzeofficial/add-dir-opencode.git
 cd add-dir-opencode
 bun install && bun run deploy
@@ -41,27 +40,15 @@ Bundles to `~/.config/opencode/plugins/add-dir.js`.
 
 </details>
 
-## Usage
-
-### Slash Command
+## Commands
 
 ```
-/add-dir /path/to/directory              # Session only
+/add-dir /path/to/directory              # Add for this session
 /add-dir /path/to/directory --remember   # Persist across sessions
-/add-dir list                            # Show added directories
-/add-dir remove /path/to/directory       # Remove a directory
+/list-dir                                # Show added directories
+/remove-dir /path/to/directory           # Remove a directory
 ```
 
-### LLM Tools
-
-The agent can also call these tools directly:
-
-| Tool | Description |
-|------|-------------|
-| `add_dir` | Add a directory (with optional `remember` flag) |
-| `list_dirs` | List all added directories |
-| `remove_dir` | Remove a directory |
-
 ## How It Works
 
 The plugin uses a layered approach to handle permissions across all sessions, including subagents:
@@ -69,13 +56,13 @@ The plugin uses a layered approach to handle permissions across all sessions, in
 | Layer | When | Scope |
 |-------|------|-------|
 | **Config hook** | Startup | Injects `external_directory: "allow"` rules for persisted dirs into all agents |
-| **Session permission** | `/add-dir` | Sets `external_directory: true` on the current session via `tools` field |
+| **Session permission** | `/add-dir` | Sets `external_directory: true` on the current session |
 | **tool.execute.before** | Every file tool | Detects subagent sessions accessing added dirs, grants permission before execution |
 | **Event auto-approve** | Permission popup | Catches any remaining `external_directory` requests and auto-approves via SDK |
 
-### AGENTS.md Injection
+### Context Injection
 
-If an added directory contains `AGENTS.md`, `CLAUDE.md`, or `.agents/AGENTS.md`, the content is automatically injected into the system prompt via `experimental.chat.system.transform`.
+If an added directory contains `AGENTS.md`, `CLAUDE.md`, or `.agents/AGENTS.md`, the content is automatically injected into the system prompt.
 
 ## Persistence
 
@@ -91,7 +78,7 @@ These are loaded at startup and injected into agent permission rules via the con
 
 ```bash
 bun install
-bun test           # 17 tests
+bun test           # 33 tests
 bun run typecheck  # Type check
 bun run build      # Build npm package
 bun run deploy     # Bundle to ~/.config/opencode/plugins/
@@ -102,24 +89,18 @@ bun run deploy     # Bundle to ~/.config/opencode/plugins/
 ```
 src/
 ├── index.ts        # Entry point (default export)
-├── plugin.ts       # Hooks + tools
-├── state.ts        # Persistence
+├── plugin.ts       # Hooks + commands
+├── state.ts        # Persistence + path utils
 ├── validate.ts     # Directory validation
 ├── permissions.ts  # Session grants + auto-approve
-└── context.ts      # AGENTS.md injection
+├── context.ts      # AGENTS.md injection
+└── types.ts        # Shared type definitions
 ```
 
 ## Debugging
 
-Run OpenCode with logs:
-
 ```bash
 opencode --print-logs 2>debug.log
-```
-
-Filter plugin logs:
-
-```bash
 grep "\[add-dir\]" debug.log
 ```
 

package/bin/setup.mjs

@@ -9,19 +9,9 @@ const isRemove = args.includes("--remove")
 
 function configDir() {
   if (process.env.XDG_CONFIG_HOME) return join(process.env.XDG_CONFIG_HOME, "opencode")
-  if (process.platform === "darwin") return join(homedir(), ".config", "opencode")
   return join(homedir(), ".config", "opencode")
 }
 
-function findConfig() {
-  const dir = configDir()
-  for (const name of ["opencode.jsonc", "opencode.json"]) {
-    const p = join(dir, name)
-    if (existsSync(p)) return p
-  }
-  return join(dir, "opencode.json")
-}
-
 function stripJsonComments(text) {
   let result = ""
   let inString = false
@@ -39,48 +29,73 @@ function stripJsonComments(text) {
   return result
 }
 
-function run() {
-  const configPath = findConfig()
-  const dir = configDir()
-
-  let config = {}
-  if (existsSync(configPath)) {
-    const raw = readFileSync(configPath, "utf-8")
-    config = JSON.parse(stripJsonComments(raw))
-  } else {
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+function findConfigFile(dir, baseName) {
+  for (const ext of [".jsonc", ".json"]) {
+    const p = join(dir, baseName + ext)
+    if (existsSync(p)) return p
   }
+  return join(dir, baseName + ".json")
+}
 
-  config.plugin = config.plugin || []
-  const has = config.plugin.some((p) => {
+function readConfig(filePath) {
+  if (!existsSync(filePath)) return {}
+  return JSON.parse(stripJsonComments(readFileSync(filePath, "utf-8")))
+}
+
+function hasPlugin(plugins) {
+  return (plugins || []).some((p) => {
     const name = Array.isArray(p) ? p[0] : p
     return name === PKG || name.startsWith(PKG + "@")
   })
+}
 
-  if (isRemove) {
-    if (!has) {
-      console.log(`${PKG} is not in ${configPath}`)
-      return
-    }
-    config.plugin = config.plugin.filter((p) => {
-      const name = Array.isArray(p) ? p[0] : p
-      return name !== PKG && !name.startsWith(PKG + "@")
-    })
-    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n")
-    console.log(`Removed ${PKG} from ${configPath}`)
-    return
-  }
+function withoutPlugin(plugins) {
+  return (plugins || []).filter((p) => {
+    const name = Array.isArray(p) ? p[0] : p
+    return name !== PKG && !name.startsWith(PKG + "@")
+  })
+}
+
+function patchConfig(filePath, config, schemaUrl) {
+  config.plugin = config.plugin || []
 
-  if (has) {
-    console.log(`${PKG} is already in ${configPath}`)
-    return
+  if (isRemove) {
+    if (!hasPlugin(config.plugin)) return false
+    config.plugin = withoutPlugin(config.plugin)
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n")
+    return true
   }
 
+  if (hasPlugin(config.plugin)) return false
   config.plugin.push(PKG)
-  if (!config.$schema) config.$schema = "https://opencode.ai/config.json"
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n")
-  console.log(`Added ${PKG} to ${configPath}`)
-  console.log("Restart OpenCode to activate the plugin.")
+  if (schemaUrl && !config.$schema) config.$schema = schemaUrl
+  writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n")
+  return true
+}
+
+function run() {
+  const dir = configDir()
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+
+  const serverPath = findConfigFile(dir, "opencode")
+  const tuiPath = findConfigFile(dir, "tui")
+
+  const serverConfig = readConfig(serverPath)
+  const tuiConfig = readConfig(tuiPath)
+
+  const verb = isRemove ? "Removed" : "Added"
+  const serverChanged = patchConfig(serverPath, serverConfig, "https://opencode.ai/config.json")
+  const tuiChanged = patchConfig(tuiPath, tuiConfig)
+
+  if (serverChanged) console.log(`${verb} ${PKG} in ${serverPath}`)
+  else console.log(`${PKG} already ${isRemove ? "absent from" : "in"} ${serverPath}`)
+
+  if (tuiChanged) console.log(`${verb} ${PKG} in ${tuiPath}`)
+  else console.log(`${PKG} already ${isRemove ? "absent from" : "in"} ${tuiPath}`)
+
+  if (serverChanged || tuiChanged) {
+    console.log("Restart OpenCode to activate the plugin.")
+  }
 }
 
 run()

package/dist/index.d.ts

@@ -1,2 +1,5 @@
-import { AddDirPlugin } from "./plugin.js";
-export default AddDirPlugin;
+import type { PluginModule } from "@opencode-ai/plugin";
+declare const plugin: PluginModule & {
+    id: string;
+};
+export default plugin;

package/dist/index.js

@@ -35,6 +35,83 @@ function matchesDirs(dirs, filepath) {
   }
   return false;
 }
+var PKG = "opencode-add-dir";
+function stripJsonComments(text) {
+  let result = "";
+  let inString = false;
+  let escape = false;
+  for (let i = 0;i < text.length; i++) {
+    const ch = text[i];
+    if (escape) {
+      result += ch;
+      escape = false;
+      continue;
+    }
+    if (ch === "\\" && inString) {
+      result += ch;
+      escape = true;
+      continue;
+    }
+    if (ch === '"') {
+      inString = !inString;
+      result += ch;
+      continue;
+    }
+    if (inString) {
+      result += ch;
+      continue;
+    }
+    if (ch === "/" && text[i + 1] === "/") {
+      while (i < text.length && text[i] !== `
+`)
+        i++;
+      continue;
+    }
+    if (ch === "/" && text[i + 1] === "*") {
+      i += 2;
+      while (i < text.length && !(text[i] === "*" && text[i + 1] === "/"))
+        i++;
+      i++;
+      continue;
+    }
+    result += ch;
+  }
+  return result;
+}
+function configDir() {
+  return join(process.env["XDG_CONFIG_HOME"] || join(process.env["HOME"] || "~", ".config"), "opencode");
+}
+function findTuiConfig() {
+  const dir = configDir();
+  for (const name of ["tui.jsonc", "tui.json"]) {
+    const p = join(dir, name);
+    if (existsSync(p))
+      return p;
+  }
+  return join(dir, "tui.json");
+}
+function ensureTuiConfig() {
+  try {
+    const dir = configDir();
+    if (!existsSync(dir))
+      mkdirSync(dir, { recursive: true });
+    const filePath = findTuiConfig();
+    let config = {};
+    if (existsSync(filePath)) {
+      config = JSON.parse(stripJsonComments(readFileSync(filePath, "utf-8")));
+    }
+    const plugins = config.plugin ?? [];
+    const hasEntry = plugins.some((p) => {
+      const name = Array.isArray(p) ? p[0] : p;
+      return name === PKG || typeof name === "string" && name.startsWith(PKG + "@");
+    });
+    if (hasEntry)
+      return;
+    config.plugin = [...plugins, PKG];
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + `
+`);
+  } catch {}
+}
 
 // src/validate.ts
 import { statSync } from "fs";
@@ -138,14 +215,11 @@ ${content}`);
 
 // src/plugin.ts
 var SENTINEL = Object.assign(new Error("__ADD_DIR_HANDLED__"), { stack: "" });
-function log(msg, data) {
-  console.error(`[add-dir] ${msg}`, data !== undefined ? JSON.stringify(data) : "");
-}
 var AddDirPlugin = async ({ client, worktree, directory }) => {
   const root = worktree || directory;
   const dirs = loadDirs();
   const sdk = client;
-  log("init", { root, persistedDirs: [...dirs.keys()] });
+  ensureTuiConfig();
   function add(dirPath, persist) {
     const result = validateDir(dirPath, root, [...dirs.values()].map((d) => d.path));
     if (!result.ok)
@@ -184,18 +258,9 @@ var AddDirPlugin = async ({ client, worktree, directory }) => {
       notify(sdk, sessionID, result.message);
   }
   const commands = {
-    "add-dir": (args, sid) => {
-      log("add-dir", { args, sid });
-      handleAdd(args, sid);
-    },
-    "list-dir": (_, sid) => {
-      log("list-dir", { sid });
-      notify(sdk, sid, list());
-    },
-    "remove-dir": (args, sid) => {
-      log("remove-dir", { args, sid });
-      notify(sdk, sid, remove(args));
-    }
+    "add-dir": (args, sid) => handleAdd(args, sid),
+    "list-dir": (_, sid) => notify(sdk, sid, list()),
+    "remove-dir": (args, sid) => notify(sdk, sid, remove(args))
   };
   return {
     config: async (cfg) => {
@@ -234,7 +299,11 @@ var AddDirPlugin = async ({ client, worktree, directory }) => {
 };
 
 // src/index.ts
-var src_default = AddDirPlugin;
+var plugin = {
+  id: "opencode-add-dir",
+  server: AddDirPlugin
+};
+var src_default = plugin;
 export {
   src_default as default
 };

package/dist/state.d.ts

@@ -7,3 +7,4 @@ export declare function loadDirs(): Map<string, DirEntry>;
 export declare function saveDirs(dirs: Map<string, DirEntry>): void;
 export declare function isChildOf(parent: string, child: string): boolean;
 export declare function matchesDirs(dirs: Map<string, DirEntry>, filepath: string): boolean;
+export declare function ensureTuiConfig(): void;

package/dist/tui-plugin.d.ts

@@ -0,0 +1,5 @@
+import type { TuiPluginModule } from "@opencode-ai/plugin/tui";
+declare const plugin: TuiPluginModule & {
+    id: string;
+};
+export default plugin;

package/dist/tui.tsx

@@ -0,0 +1,110 @@
+import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { createSignal } from "solid-js"
+
+const PLUGIN_ID = "opencode-add-dir"
+const COMMAND_NAME = "add-dir"
+
+function activeSessionID(api: TuiPluginApi): string | undefined {
+  const route = api.route.current
+  if (route.name !== "session" || !route.params) return
+  return route.params.sessionID as string
+}
+
+async function ensureSession(api: TuiPluginApi): Promise<string | undefined> {
+  const existing = activeSessionID(api)
+  if (existing) return existing
+
+  const res = await api.client.session.create({})
+  if (res.error) return
+
+  api.route.navigate("session", { sessionID: res.data.id })
+  return res.data.id
+}
+
+async function executeAddDir(api: TuiPluginApi, dirPath: string) {
+  const sessionID = await ensureSession(api)
+  if (!sessionID) {
+    api.ui.toast({ variant: "error", message: "Failed to create session" })
+    return
+  }
+
+  // The server plugin intercepts via command.execute.before, handles the logic,
+  // sends feedback through the session event stream, then throws SENTINEL to
+  // prevent the command template from reaching the LLM. This rejection is expected.
+  api.client.session.command({
+    sessionID,
+    command: COMMAND_NAME,
+    arguments: dirPath,
+  }).catch(() => {})
+}
+
+function AddDirDialog(props: { api: TuiPluginApi }) {
+  const [busy, setBusy] = createSignal(false)
+
+  async function handleConfirm(value: string) {
+    const dirPath = value.trim()
+    if (!dirPath) {
+      props.api.ui.toast({ variant: "error", message: "Please enter a directory path" })
+      return
+    }
+
+    setBusy(true)
+    try {
+      await executeAddDir(props.api, dirPath)
+      props.api.ui.dialog.clear()
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <props.api.ui.DialogPrompt
+      title="Add directory"
+      placeholder="/path/to/directory"
+      busy={busy()}
+      busyText="Adding directory..."
+      description={() => (
+        <box gap={0}>
+          <text fg={props.api.theme.current.textMuted}>
+            To get the full path of a project:
+          </text>
+          <text fg={props.api.theme.current.textMuted}>
+            {" "}1. Move to the project in your terminal
+          </text>
+          <text fg={props.api.theme.current.textMuted}>
+            {" "}2. Run "pwd" and copy the output
+          </text>
+          <text fg={props.api.theme.current.textMuted}>
+            {" "}3. Paste below
+          </text>
+        </box>
+      )}
+      onConfirm={handleConfirm}
+      onCancel={() => props.api.ui.dialog.clear()}
+    />
+  )
+}
+
+function showDialog(api: TuiPluginApi) {
+  api.ui.dialog.replace(() => <AddDirDialog api={api} />)
+}
+
+const tui: TuiPlugin = async (api) => {
+  api.command.register(() => [
+    {
+      title: "Add directory",
+      value: "add-dir.dialog",
+      description: "Add a working directory to the session",
+      category: "Directories",
+      slash: { name: COMMAND_NAME },
+      onSelect: () => showDialog(api),
+    },
+  ])
+}
+
+const plugin: TuiPluginModule & { id: string } = {
+  id: PLUGIN_ID,
+  tui,
+}
+
+export default plugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-add-dir",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Add working directories to your OpenCode session with auto-approved permissions",
   "author": "Cristian Fonseca <cfonsecacomas@gmail.com>",
   "type": "module",
@@ -8,10 +8,20 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./server": {
+      "import": "./dist/index.js"
+    },
+    "./tui": {
+      "import": "./dist/tui.tsx"
     }
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "oc-plugin": [
+    "server",
+    "tui"
+  ],
   "bin": {
     "opencode-add-dir-setup": "./bin/setup.mjs"
   },
@@ -22,8 +32,10 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm --external @opencode-ai/plugin && bun x tsc --emitDeclarationOnly",
-    "deploy": "bun build ./src/plugin.ts --outfile ~/.config/opencode/plugins/add-dir.js --target node --format esm --external @opencode-ai/plugin",
+    "build": "bun run build:server && bun run build:tui && bun x tsc --emitDeclarationOnly",
+    "build:server": "bun build ./src/index.ts --outdir ./dist --target node --format esm --external @opencode-ai/plugin",
+    "build:tui": "cp ./src/tui-plugin.tsx ./dist/tui.tsx",
+    "deploy": "bun run build:server && bun run build:tui",
     "test": "bun test",
     "typecheck": "bun x tsc --noEmit",
     "prepublishOnly": "bun run typecheck && bun test && bun run build"
@@ -41,10 +53,22 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.0.0"
+    "@opencode-ai/plugin": ">=1.0.0",
+    "@opentui/core": ">=0.1.92",
+    "@opentui/solid": ">=0.1.92"
+  },
+  "peerDependenciesMeta": {
+    "@opentui/core": {
+      "optional": true
+    },
+    "@opentui/solid": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.1.14",
+    "@opentui/core": "0.1.95",
+    "@opentui/solid": "0.1.95",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
@@ -53,6 +77,7 @@
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/bun": "latest",
     "semantic-release": "^25.0.3",
+    "solid-js": "^1.9.12",
     "typescript": "^5.8.3"
   }
 }