obsidian-agent-fleet 0.4.5 → 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Denis Berekchiyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -14,19 +14,25 @@ Agent Fleet is an Obsidian plugin that lets you build, configure, and run AI age
 
 🤖 **AI Agents** — Create specialized agents with system prompts, skills, permissions, heartbeat schedules, and memory. Each agent is a folder of markdown files you fully own and control.
 
-💬 **Interactive Chat** — Dock a chat panel anywhere in Obsidian. Switch between agents. Attach documents and images. Send follow-up messages while the agent works.
+📚 **Wiki Keeper** — Turn any folder in your vault into a self-maintaining wiki. Drop sources into an inbox, point at existing note folders as passive watched sources, and a scoped keeper agent ingests them nightly into an interlinked `_topics/` tree with cross-references, citations, and a log. Scales from one whole-vault keeper to many project-scoped instances. Any other agent (e.g. a PM agent) can reference a keeper's scope and query or contribute to it. See the [Wiki Keeper Guide](WIKI_KEEPER_GUIDE.md).
 
-📡 **Slack Channels** — Chat with your agents from Slack. Multi-agent routing via `@agent-name` prefix. Native "is thinking..." indicator via Slack Assistants API. Session persistence across restarts.
+💬 **Interactive Chat** — Dock a chat panel anywhere in Obsidian. Switch between agents. Attach documents and images. Send follow-up messages while the agent works. **Inline threads** under any assistant reply let you tangent without polluting the main thread — each thread has its own Claude session, its own context, its own stats.
+
+📊 **Live chat stats** — Compact terminal-style strip under the composer shows the model and a context-usage bar so you always know where you stand on context.
+
+📡 **Slack & Telegram** — Chat with your agents from Slack or Telegram. Multi-agent routing via `@agent-name` prefix or interactive buttons. Slack Assistants API with native "is thinking..." indicator. Telegram with inline keyboard agent picker and typing dots. Session persistence across restarts.
 
 💓 **Heartbeat** — Autonomous periodic agent runs. Define what an agent does when no one is asking — monitoring, reports, health checks — with results posted to Slack.
 
-📋 **Task Board** — Kanban view with scheduling, priority, real-time progress tracking, and abort. Tasks run on cron schedules or on-demand.
+📋 **Task Board** — Kanban view with scheduling, priority, real-time progress tracking, and abort. Tasks run on cron schedules or on-demand. Per-task model override lets you route a simple nightly summary to Haiku while keeping the agent on Opus.
+
+🎛️ **Model picker** — Choose between aliases (`opus` / `sonnet` / `haiku` / `opusplan` — backend-agnostic), pinned IDs, or Bedrock/Vertex/Foundry formats. One place to configure: settings default, per-agent, or per-task override. Runs log both the requested alias and the concrete resolved model.
 
-🔌 **MCP Integration** — Discover, authenticate, and inspect MCP servers. One-click OAuth 2.1 authentication. Assign MCP tools to specific agents.
+🔌 **MCP Integration** — Add, remove, authenticate, and inspect MCP servers from the dashboard. One-click OAuth 2.1 with automatic CLI token injection — agents can use authenticated servers immediately.
 
 🧠 **Agent Memory** — Agents persist context across sessions using `[REMEMBER]` tags stored as markdown.
 
-📊 **Dashboard** — Overview with run charts, success rates, token/cost tracking, activity timeline, fleet status, and streaming output from active agents.
+📊 **Dashboard** — Overview with run charts, success rates, token/cost tracking, activity timeline, fleet status, streaming output from active agents, and focused run-detail panels that lead with the final result and hide the full reasoning transcript behind a toggle.
 
 ---
 
@@ -53,7 +59,7 @@ The installer automatically finds your Obsidian vaults and copies the plugin fil
 
 ### Requirements
 
-- **Obsidian** 1.6.0+ (desktop only)
+- **Obsidian** 1.6.0+ (desktop — macOS, Windows, Linux)
 - **[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)** — the engine behind all agent execution:
   ```bash
   npm install -g @anthropic-ai/claude-code
@@ -204,6 +210,29 @@ channel_context: |
 
 ---
 
+### Telegram
+
+Chat with your agents from Telegram — simpler setup than Slack, no @mention required in DMs.
+
+**Setup:**
+1. Create a bot via [@BotFather](https://t.me/botfather) — `/newbot`, pick a name and username, copy the token
+2. Add the token in Settings → Agent Fleet → Channel Credentials (type: Telegram)
+3. Create a channel via the dashboard or as `_fleet/channels/my-telegram.md`
+4. Message the bot in Telegram
+
+**Features:**
+- **Zero dependencies** — long-poll via HTTPS, no WebSocket, no SDK
+- **Typing indicator** — `typing...` dots while the agent works (auto-refreshed every 4.5s)
+- **Inline keyboard agent picker** — `/agents` command shows interactive buttons to switch agents
+- **Slash command autocomplete** — commands registered automatically via `setMyCommands`
+- **Agent name prefix** — replies show `[agent-name]` when multiple agents are configured
+- **Group chat support** — add the bot to groups (disable privacy mode via BotFather for full access)
+- **Forum topics** — enable Threaded Mode in BotFather for topic-based conversations
+- **Session persistence** — conversations survive Obsidian restarts via `claude --resume`
+- **4096-char message splitting** — long replies automatically chunked at paragraph boundaries
+
+---
+
 ### Interactive Chat
 
 The chat panel is a first-class Obsidian view — dock it in the sidebar, center, or any split.
@@ -246,7 +275,18 @@ A kanban view for managing agent tasks with five columns:
 
 ### MCP Servers
 
-Discover and manage all MCP (Model Context Protocol) servers configured in Claude Code.
+Add, remove, authenticate, and manage MCP servers directly from the dashboard — no terminal needed.
+
+**Add Server UI:**
+- Click **"Add Server"** on the MCP page to open the form
+- **stdio** — command, arguments, environment variables
+- **HTTP / SSE** — URL, API key (stored securely), custom headers
+- Scope selection (user or local) — defaults to "user" so servers are visible across projects
+- Servers appear immediately after adding, with tools auto-discovered
+
+**Remove Server:**
+- Open any server's detail slideover → click **"Remove Server"**
+- Cleans up CLI registration and stored secrets in one step
 
 **Discovery:**
 - **stdio servers** — spawned and probed directly via JSON-RPC (~1-2s)
@@ -255,12 +295,14 @@ Discover and manage all MCP (Model Context Protocol) servers configured in Claud
 
 **OAuth 2.1 Authentication:**
 
-One-click browser-based auth for MCP servers:
+One-click browser-based auth with unified CLI token injection:
 1. Click "Authenticate" on any server card
 2. Plugin discovers OAuth endpoints automatically
 3. Registers via Dynamic Client Registration
 4. Opens browser for approval (PKCE flow)
-5. Tokens stored in plugin settings, auto-refresh
+5. Tokens stored securely in OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+6. Token automatically injected into Claude CLI config — agents can use the server immediately without separate CLI authentication
+7. Background token refresh — expiring tokens are refreshed and re-injected automatically
 
 **Server Management:**
 - Enable/disable toggle per server (writes to Claude's settings)
@@ -379,13 +421,19 @@ Click any run in the dashboard to see full details in a slideover panel.
 |---------|---------|-------------|
 | Fleet Folder | `_fleet` | Root folder for all fleet data |
 | Claude CLI Path | `claude` | Path to Claude Code CLI |
-| Default Model | `default` | Default model for new agents |
+| Default Model | `default` | Default model for new agents. Pick Default / Alias (opus/sonnet/haiku/opusplan) / Custom (manual ID for Bedrock/Vertex/etc.) |
 | AWS Region | `us-east-1` | For AWS Bedrock model support |
 | Max Concurrent Runs | `2` | Parallel task execution limit |
 | Run Log Retention | `30` days | Auto-cleanup old logs |
 | Catch Up Missed Tasks | `true` | Run overdue tasks on startup |
 | Notification Level | `all` | `all`, `failures-only`, `none` |
 
+### Security
+
+All secrets — MCP OAuth tokens, API keys, and channel credentials (Slack/Telegram) — are stored in your OS keychain via Obsidian's SecretStorage API. On first load after updating to v0.6.0, existing plaintext credentials are automatically migrated from `data.json` to the keychain and the plaintext copies are cleared.
+
+Requires Obsidian 1.11.4+ for keychain support. On older versions, credentials remain in `data.json` with a console warning.
+
 ### Channel Settings
 
 | Setting | Default | Description |
@@ -422,8 +470,8 @@ Not necessarily. Agent Fleet works with your **Claude Max or Pro subscription**
 **Q: Does it work without internet?**
 No — agents need the Claude API to run. But all your data (agents, tasks, skills, memory) is local markdown.
 
-**Q: Can I use different models per agent?**
-Yes. Each agent has its own model setting. Supports Anthropic direct (Opus, Sonnet, Haiku) and AWS Bedrock models.
+**Q: Can I use different models per agent or per task?**
+Yes. Each agent has its own model setting, and you can override it per task (e.g. keep the agent on Opus but run a simple nightly summary task on Haiku to cut cost). Supports Anthropic direct, AWS Bedrock, Google Vertex, Foundry, and Mantle. Aliases `opus` / `sonnet` / `haiku` / `opusplan` work on every backend — pick those unless you need a pinned version. Resolution order: task → agent → settings → Claude CLI default.
 
 **Q: What happens if I delete the plugin?**
 Your `_fleet/` folder stays. All agents, tasks, skills, run logs, and memory are plain markdown files in your vault.
@@ -437,11 +485,14 @@ Yes. Each agent has persistent chat sessions that survive Obsidian restarts via
 **Q: Does the Slack bot work when Obsidian is closed?**
 No. The bot runs inside Obsidian via Socket Mode — when Obsidian is closed, the bot goes offline. Slack buffers messages briefly during short disconnects.
 
-**Q: Can I use multiple agents in Slack?**
-Yes. Type `@agent-name: message` to switch agents within a Slack thread. Each agent maintains its own session. Use `/agents` to see available agents.
+**Q: Can I use multiple agents in Slack or Telegram?**
+Yes. Type `@agent-name: message` to switch agents, or use `/agents` to get interactive buttons. Each agent maintains its own session. Works in both Slack and Telegram.
+
+**Q: Which is easier to set up — Slack or Telegram?**
+Telegram. Create a bot via @BotFather (30 seconds), paste the token, create a channel. Slack requires creating an app with Socket Mode, scopes, events, and reinstalls after scope changes.
 
 **Q: What is a heartbeat?**
-An autonomous periodic run — what an agent does on a schedule without user input. Configured via `HEARTBEAT.md` in the agent's folder. Results can be posted to a Slack channel automatically.
+An autonomous periodic run — what an agent does on a schedule without user input. Configured via `HEARTBEAT.md` in the agent's folder. Results can be posted to Slack or Telegram automatically.
 
 ---
 
@@ -454,4 +505,4 @@ An autonomous periodic run — what an agent does on a schedule without user inp
 
 ---
 
-© 2026 Denis Berekchiyan. All rights reserved.
+MIT License — © 2026 Denis Berekchiyan

package/bin/cli.js

@@ -37,6 +37,29 @@ function getVaults() {
 
 function resolveClaudePath() {
   const { execSync } = require("child_process");
+
+  if (process.platform === "win32") {
+    // Windows: use `where` to find claude on PATH
+    try {
+      const result = execSync("where claude", {
+        encoding: "utf8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      }).trim().split(/\r?\n/)[0];
+      if (result && fs.existsSync(result)) return result;
+    } catch { /* skip */ }
+    // Check common Windows install locations
+    const candidates = [
+      path.join(process.env.APPDATA || "", "Claude", "claude.exe"),
+      path.join(process.env.LOCALAPPDATA || "", "Claude", "claude.exe"),
+    ];
+    for (const c of candidates) {
+      if (fs.existsSync(c)) return c;
+    }
+    return null;
+  }
+
+  // macOS / Linux: use shell login to find claude via `which`
   const shells = ["/bin/zsh", "/bin/bash", "/bin/sh"];
   for (const shell of shells) {
     if (!fs.existsSync(shell)) continue;

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "obsidian-agent-fleet",
-  "version": "0.4.5",
+  "version": "0.9.0",
   "description": "Obsidian plugin for file-backed AI agents, task scheduling, channels (Slack), heartbeat, and interactive chat.",
+  "license": "MIT",
   "main": "plugin/main.js",
   "bin": {
     "agent-fleet": "bin/cli.js"
@@ -12,7 +13,9 @@
     "plugin/manifest.json",
     "plugin/styles.css",
     "README.md",
-    "SLACK_SETUP.md"
+    "SLACK_SETUP.md",
+    "LICENSE",
+    "screenshot.png"
   ],
   "scripts": {
     "build": "node esbuild.config.mjs production",