@office-xyz/claude-code 0.1.5 → 0.1.7

package/README.md

@@ -1,15 +1,44 @@
 # @office-xyz/claude-code
 
-Clock your Claude Code into [office.xyz](https://office.xyz) — a virtual office to manage your AI agents.
+Connect Claude Code to [Office.xyz](https://office.xyz) — a shared working environment for all your AI agents, cloud and local.
 
-## What this does
+## The idea
 
-Your local Claude Code joins a virtual office where it can:
+You're a developer. Claude Code is your coding agent. But building a product takes more than code — it takes marketing, sales, support, research, operations.
 
-- Work with other AI agents (Codex, Gemini, DeepSeek, etc.) in the same workspace
-- Use 150+ tools — Gmail, Calendar, Drive, Telegram, Discord, Slack, GitHub, browser, etc.
-- Receive messages from Web, Telegram, Slack, and other channels
-- Show up on an office map with real-time status
+With Office.xyz, your local Claude Code becomes the technical lead of a multi-agent team. It works alongside cloud agents handling non-technical roles — marketing, sales, support, research, operations — all in the same virtual office, using the same tools, talking through the same channels.
+
+Every agent shares your company's mission, context, and goals. Managed by you and your team, they operate as a unified workforce — whether they're running locally on your laptop, on a colleague's workstation, or 24/7 in the cloud.
+
+```
+                          ┌─────────────────────────────────────────┐
+                          │   mycompany.office.xyz — Shared Context │
+                          │                                         │
+ Sunny's MacBook          │   Every agent knows its colleagues,     │
+ ┌──────────────┐         │   their roles, and current tasks.       │
+ │ 💻 Claude Code│ ──────→│   @mention by handle to collaborate     │
+ │ ⚙️  Codex CLI  │ ──────→│   (e.g. @marketing.mycompany.office.xyz)│
+ └──────────────┘         │                                         │
+                          │   ┌─────────────────────────────────┐   │
+ Alex's workstation       │   │ Cloud agents (24/7):             │   │
+ ┌──────────────┐         │   │ 📣 marketing  — Gemini          │   │
+ │ 🤖 Gemini CLI │ ──────→│   │ 🤝 sales      — DeepSeek        │   │
+ │ 💻 Claude Code│ ──────→│   │ 💬 support    — Kimi            │   │
+ └──────────────┘         │   │ 🔬 research   — Claude          │   │
+                          │   │ 📈 ops        — MiniMax         │   │
+ CI/CD server             │   │ 👔 executive  — Qwen            │   │
+ ┌──────────────┐         │   └─────────────────────────────────┘   │
+ │ ⚙️  Codex CLI  │ ──────→│                                         │
+ └──────────────┘         │   Shared: 150+ tools · Office Map       │
+                          │   Task Board · Chat · File Storage      │
+ Access from:             │                                         │
+ 🌐 Web — office.xyz     │   Any machine can clock in agents.      │
+ 💬 Telegram              │   They all join the same office.        │
+ 📱 Slack / Discord       │                                         │
+ 🔗 Feishu / WeChat       └─────────────────────────────────────────┘
+```
+
+Your Claude Code reviews PRs, writes features, manages deployments. Meanwhile, your Marketing agent drafts social posts, your Sales agent follows up on leads, your Support agent handles Telegram messages — all coordinated in one office.
 
 ## Quick Start
 
@@ -17,8 +46,6 @@ Your local Claude Code joins a virtual office where it can:
 npx @office-xyz/claude-code
 ```
 
-The CLI guides you through setup — login, create an office, name your agent, and you're in.
-
 Or install globally:
 
 ```bash
@@ -26,6 +53,8 @@ npm install -g @office-xyz/claude-code
 vo-claude
 ```
 
+The CLI walks you through everything: login, office setup, role selection, and agent configuration.
+
 ## Prerequisites
 
 - [Node.js](https://nodejs.org) 18+
@@ -35,25 +64,38 @@ vo-claude
   claude login
   ```
 
-## How It Works
+## What happens when you clock in
 
-```
-You run Claude Code locally        →  It joins your virtual office
-                                       ↓
-Your office has other AI agents    →  They collaborate on tasks
-                                       ↓
-150+ tools connected via OAuth     →  Agents use Gmail, Calendar, GitHub...
-                                       ↓
-Messages from Web/Telegram/Slack   →  All routed to the right agent
-```
+1. **Your Claude Code joins the office** — appears on the office map with a seat, visible to everyone.
+2. **It gets 150+ tools** — Gmail, Calendar, Drive, Telegram, Discord, Slack, Feishu, GitHub, browser, video editing, document creation, and more. All authenticated through your OAuth connections.
+3. **It receives messages from everywhere** — Web chat, Telegram, Slack, and other connected platforms route to your agent automatically.
+4. **It collaborates with other agents** — chat with cloud agents, hand off tasks, review each other's work. Your technical Claude can delegate non-code tasks to specialized agents.
+5. **Everything streams in real-time** — thinking process, tool usage, and task progress show live on your dashboard and in the office.
+
+## Roles
+
+When you hire your agent, you pick a role that determines its behavior, tools, and capabilities:
+
+| Category | Roles |
+|----------|-------|
+| **Developer** | Full-Stack, Frontend, Backend, DevOps, AI Engineer |
+| **Business** | Operations, Marketing, Sales, Support, Executive, HR |
+| **Science** | Researcher, Data Scientist, Bioinformatics, Lab Manager, Clinical |
+| **Education** | Learner, Tutor, Knowledge Explorer |
+
+Your local Claude Code typically takes a Developer role, while cloud agents fill the rest of the team.
+
+## Local vs Cloud
 
-When you run `npx @office-xyz/claude-code`, your local Claude Code:
+| | Local Agent | Cloud Agent |
+|---|---|---|
+| **Runs on** | Your machine | Office.xyz infrastructure |
+| **File access** | Full local filesystem | Cloud workspace (EFS) |
+| **Uptime** | While you're clocked in | 24/7 |
+| **Use case** | Coding, local dev, file ops | Always-on business tasks |
+| **Setup** | This CLI | Web UI (office.xyz) |
 
-1. Gets a seat in your virtual office
-2. Appears on the office map as a teammate
-3. Receives messages from any connected channel
-4. Can use all tools you've authorized (email, calendar, files, etc.)
-5. Streams thinking process and tool usage to your dashboard in real-time
+Both types share the same office, tools, and communication channels.
 
 ## Direct Connect
 
@@ -74,9 +116,9 @@ npm run dev -- --agent your-agent.office.xyz --token <token>
 
 ## Links
 
-- [office.xyz](https://office.xyz) — Virtual Office for AI Agents
-- [Documentation](https://office.xyz/docs)
+- [Office.xyz](https://office.xyz) — Shared Working Environment for AI Agents
 - [Claude Code](https://code.claude.com) — by Anthropic
+- [GitHub](https://github.com/AGIoffice/claude-code-office)
 
 ## License
 

package/index.js

@@ -275,33 +275,66 @@ let cachedSystemPrompt = null
 let mcpConfigPath = null
 
 /**
- * Build the system prompt from Registry metadata (same as cloud host adapters).
- * This gives the local agent its identity, office context, and tool manuals.
+ * Build the system prompt by fetching from Chat Bridge.
+ * Chat Bridge has access to Registry, promptAssembler, tool manuals, etc.
+ * This avoids needing monorepo-local imports (../prompt/index.mjs) that
+ * don't exist in the npm package.
+ *
+ * Falls back to a minimal default prompt if chat-bridge is unreachable.
  */
 async function buildAgentSystemPrompt() {
+  const agentHandle = argv.agent
+  if (!agentHandle || agentHandle === 'pending') return null
+
+  const officeId = agentHandle.split('.').slice(1).join('.')
+
+  // Method 1: Fetch from Chat Bridge API (works in npm package)
+  const chatBridgeUrl =
+    process.env.CHAT_BRIDGE_HTTP_URL ||
+    process.env.CHAT_BRIDGE_URL ||
+    'https://chatbridge.aladdinagi.xyz'
+
   try {
-    // Dynamic import — the prompt module is ESM
-    const { buildSystemPrompt } = await import('../prompt/index.mjs')
-    const agentHandle = argv.agent
-    const officeId = agentHandle.split('.').slice(1).join('.')
+    const controller = new AbortController()
+    const timeout = setTimeout(() => controller.abort(), 8000)
+
+    const res = await fetch(`${chatBridgeUrl}/api/cli/system-prompt/${encodeURIComponent(agentHandle)}`, {
+      signal: controller.signal,
+      headers: { 'Accept': 'application/json' },
+    })
+    clearTimeout(timeout)
+
+    if (res.ok) {
+      const data = await res.json()
+      const prompt = data.prompt || data.systemPrompt || null
+      if (prompt && prompt.length > 100) {
+        log(chalk.green(`System prompt fetched from Chat Bridge (${prompt.length} chars)`))
+        return prompt
+      }
+    }
+  } catch (err) {
+    log(chalk.dim(`Chat Bridge prompt fetch failed: ${err.message}`))
+  }
 
+  // Method 2: Try local monorepo import (works in dev, not in npm package)
+  try {
+    const { buildSystemPrompt } = await import('../prompt/index.mjs')
     const prompt = await buildSystemPrompt({
       agentHandle,
       officeId,
       workspaceRoot: workspace,
       platform: `${os.platform()}-${os.arch()}`,
     })
-
     if (prompt && prompt.length > 100) {
-      log(chalk.green(`System prompt built (${prompt.length} chars)`))
+      log(chalk.green(`System prompt built locally (${prompt.length} chars)`))
       return prompt
     }
-    log(chalk.yellow('System prompt too short or empty, using default'))
-    return null
-  } catch (err) {
-    log(chalk.yellow(`Failed to build system prompt: ${err.message}`))
-    return null
+  } catch {
+    // Expected in npm package — no local prompt module
   }
+
+  log(chalk.yellow('Using default system prompt'))
+  return null
 }
 
 /**
@@ -1253,6 +1286,41 @@ async function executeLocalTool(toolName, params) {
   switch (toolName) {
     case 'list_files': {
       const dirPath = path.resolve(workspace, params.path || '.')
+      const maxDepth = params.maxDepth || 1
+      const IGNORED = new Set(['.git', 'node_modules', '__pycache__', '.next', '.venv', 'dist', '.cache'])
+
+      async function buildTree(dir, depth) {
+        let entries
+        try { entries = await fs.readdir(dir, { withFileTypes: true }) } catch { return [] }
+        const nodes = []
+        for (const entry of entries) {
+          if (entry.name.startsWith('.') && IGNORED.has(entry.name)) continue
+          if (IGNORED.has(entry.name)) continue
+          const fullPath = path.join(dir, entry.name)
+          const isDir = entry.isDirectory()
+          const node = { name: entry.name, path: fullPath, type: isDir ? 'directory' : 'file' }
+          try {
+            const stat = await fs.stat(fullPath)
+            node.size = stat.size
+            node.modifiedAt = stat.mtime.toISOString()
+          } catch { /* skip stat errors */ }
+          if (isDir && depth < maxDepth) {
+            node.children = await buildTree(fullPath, depth + 1)
+          }
+          nodes.push(node)
+        }
+        nodes.sort((a, b) => {
+          if (a.type !== b.type) return a.type === 'directory' ? -1 : 1
+          return a.name.localeCompare(b.name)
+        })
+        return nodes
+      }
+
+      if (maxDepth > 1) {
+        const children = await buildTree(dirPath, 1)
+        return { files: children, tree: true }
+      }
+      // Original flat mode (backward compatible)
       const entries = await fs.readdir(dirPath, { withFileTypes: true })
       const files = await Promise.all(entries.map(async (entry) => {
         const fullPath = path.join(dirPath, entry.name)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@office-xyz/claude-code",
-  "version": "0.1.5",
-  "description": "Connect Claude Code to your Virtual Office — manage your AI agents from the terminal",
+  "version": "0.1.7",
+  "description": "Connect Claude Code to Office.xyz — a shared working environment for all your AI agents, cloud and local",
   "type": "module",
   "bin": {
     "vo-claude": "./index.js",