-
Notifications
You must be signed in to change notification settings - Fork 50
Expand file tree
/
Copy pathdocs.html
More file actions
283 lines (254 loc) · 29.3 KB
/
Copy pathdocs.html
File metadata and controls
283 lines (254 loc) · 29.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Documentation — BagIdea Office</title>
<meta name="description" content="Full documentation for BagIdea Office: what it is, every feature, installation, usage, plugins, and the complete CLI reference.">
<link rel="icon" href="img/logo.png">
<link rel="stylesheet" href="assets/site.css">
<script defer src="assets/i18n.js"></script>
</head>
<body>
<nav>
<div class="wrap">
<a class="brand" href="index.html"><img src="img/logo.png" alt="BagIdea Office logo"> BAG<span>IDEA</span> Office</a>
<div class="links">
<a class="nav-hide" href="index.html#features" data-i18n="nav_features">Features</a>
<a class="nav-hide" href="tools.html" data-i18n="nav_tools">Tools</a>
<a class="nav-hide" href="plugins.html" data-i18n="nav_plugins">Plugins</a>
<a class="nav-hide" href="showcase.html" data-i18n="nav_showcase">Showcase</a>
<a class="nav-hide" href="index.html#install" data-i18n="nav_install">Install</a>
<a class="nav-hide" href="index.html#sponsors" data-i18n="nav_sponsors">Sponsors</a>
<a class="btn ghost" href="https://github.com/bagidea/bagidea-office" target="_blank" rel="noopener" data-i18n="cta_github">GitHub</a>
<div class="langpick"><button class="toggle">🌐 <span class="cur">EN</span></button></div>
</div>
</div>
</nav>
<div class="docwrap">
<!-- SIDEBAR -->
<aside class="docnav">
<a href="index.html" data-i18n="d_back">← Home</a>
<a href="#guides" data-i18n="dn_guides">📚 Full guides</a>
<h4 data-i18n="dn_intro">Introduction</h4>
<a href="#intro" data-i18n="dn_what">What it is</a>
<a href="#concepts" data-i18n="dn_concepts">Core concepts</a>
<h4 data-i18n="dn_install">Installation</h4>
<a href="#install-win" data-i18n="dn_install_win">Windows (one-shot)</a>
<a href="#install-mac" data-i18n="dn_install_mac">macOS (one-shot)</a>
<a href="#install-manual" data-i18n="dn_install_manual">Manual build</a>
<a href="#install-first" data-i18n="dn_install_first">First run</a>
<a href="#install-fix" data-i18n="dn_install_fix">If it fails</a>
<h4 data-i18n="dn_using">Using it</h4>
<a href="#chat" data-i18n="dn_chat">Chat & the CEO</a>
<a href="#projects" data-i18n="dn_projects">Projects</a>
<a href="#security" data-i18n="dn_security">Permissions</a>
<a href="#editor" data-i18n="dn_editor">3D Editor</a>
<a href="#voice" data-i18n="dn_voice">Voice & channels</a>
<a href="#updates" data-i18n="dn_updates">Updates & start-up</a>
<h4 data-i18n="dn_features">More</h4>
<a href="#brains" data-i18n="dn_brains">Swappable brains</a>
<a href="#plugins" data-i18n="dn_plugins">Plugins & skills</a>
<a href="#workflow" data-i18n="dn_workflow">Workflow Builder</a>
<a href="#lang" data-i18n="dn_lang">Languages</a>
<a href="#sponsors" data-i18n="dn_sponsors">Sponsoring</a>
<a href="https://github.com/bagidea/bagidea-office/blob/main/CHANGELOG.md" target="_blank" rel="noopener" data-i18n="dn_changelog">Changelog ↗</a>
<h4 data-i18n="dn_cli">CLI</h4>
<a href="#cli" data-i18n="dn_cli">CLI reference</a>
<a href="#faq" data-i18n="dn_faq">FAQ</a>
</aside>
<!-- CONTENT -->
<main class="doc">
<h1 data-i18n="d_title">Documentation</h1>
<p class="muted" data-i18n="d_sub">Everything about BagIdea Office — what it is, every feature, how to install, and the full CLI.</p>
<h2 id="intro" data-i18n="d_intro_h">Introduction</h2>
<p data-i18n="d_intro_p1">BagIdea Office is a living AI-agent office that runs as your desktop wallpaper. Every AI agent on your machine becomes a pixel-art employee in an HD-2D office: they walk to their desks when real work starts, gather at Security to ask permission, hold meetings, learn skills, and the lights follow your real local time.</p>
<p data-i18n="d_intro_p2">It is not a dashboard and not a chat window — it is a world that renders the true state of your Claude Code sessions, headless agent runs and custom scripts as living characters, behind your desktop icons.</p>
<p data-i18n="d_intro_p3">Three independent layers keep it robust: a zero-dependency Node daemon (the source of truth), a Godot 4 renderer (the wallpaper), and a lightweight overlay UI (chat, settings, approvals). The daemon keeps agents running even if rendering restarts.</p>
<img src="img/world.png?v=5" alt="BagIdea Office overview">
<h2 id="guides" data-i18n="d_guides_h">📚 Full guides — how to use every feature</h2>
<p data-i18n="d_guides_p">This page is the overview. For step-by-step how-to on every feature — hiring agents, projects, channels, web automation, voice, plugins, models and more — open the full guides (they render on GitHub):</p>
<div style="display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:10px;margin:14px 0 6px">
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/getting-started.md" target="_blank" rel="noopener" data-i18n="dg_start">🚀 Getting started</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/agents.md" target="_blank" rel="noopener" data-i18n="dg_agents">🧑💼 Agents & hiring</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/projects.md" target="_blank" rel="noopener" data-i18n="dn_projects">📁 Projects</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/office-ops.md" target="_blank" rel="noopener" data-i18n="dg_ops">🗂 Office Ops</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/channels.md" target="_blank" rel="noopener" data-i18n="dg_channels">📡 Channels</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/web-automation.md" target="_blank" rel="noopener" data-i18n="dg_web">🧭 Web automation</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/models.md" target="_blank" rel="noopener" data-i18n="dn_brains">🧠 Swappable brains</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/cost-and-vision.md" target="_blank" rel="noopener" data-i18n="dg_cost">💸 Cost & vision</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/voice-feed.md" target="_blank" rel="noopener" data-i18n="dn_voice">🎤 Voice & feed</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/plugins.md" target="_blank" rel="noopener" data-i18n="dn_plugins">🔌 Plugins & skills</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/plugin-hub.md" target="_blank" rel="noopener" data-i18n="dg_hub">🧩 Plugin Hub</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/workflows.md" target="_blank" rel="noopener" data-i18n="dn_workflow">🔀 Workflow Builder</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/editor.md" target="_blank" rel="noopener" data-i18n="dn_editor">🏢 3D Editor</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/ai-features.md" target="_blank" rel="noopener" data-i18n="dg_ai">✨ AI features</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/cli.md" target="_blank" rel="noopener" data-i18n="dn_cli">⌨️ CLI reference</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/updates.md" target="_blank" rel="noopener" data-i18n="dn_updates">🔄 Updates & start-up</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/troubleshooting.md" target="_blank" rel="noopener" data-i18n="dg_trouble">🛠 Troubleshooting</a>
<a class="btn ghost sm" href="https://github.com/bagidea/bagidea-office/blob/main/docs/guide/sponsors.md" target="_blank" rel="noopener" data-i18n="dn_sponsors">💖 Sponsoring</a>
</div>
<p class="muted" style="font-size:13px"><a href="https://github.com/bagidea/bagidea-office/tree/main/docs/guide" target="_blank" rel="noopener" data-i18n="dg_all">Browse all guides on GitHub ↗</a></p>
<h2 id="what" data-i18n="d_what_h">What it is</h2>
<p data-i18n="d_what_p">At its heart, BagIdea Office is an operations layer for AI agents — given a place. Instead of a flat list of tasks, you get a spatial, honest view of what your agents are actually doing:</p>
<ul>
<li data-i18n="d_what_l1">Real Claude Code sessions, spawned with each agent's persona, skills and allowed tools.</li>
<li data-i18n="d_what_l2">A CEO → Director → team chain of command you drive by giving orders.</li>
<li data-i18n="d_what_l3">Spatialized permission approvals — agents walk to Security for tools you haven't granted.</li>
<li data-i18n="d_what_l4">Real project folders, resumable sessions, and self-splitting sub-agents for parallel work.</li>
</ul>
<h2 id="concepts" data-i18n="d_concepts_h">Core concepts</h2>
<h3 data-i18n="d_c_ceo_h">You are the CEO</h3>
<p data-i18n="d_c_ceo_p">The gold seat is you. Type an order and the Director (the main Claude agent) walks over, takes it, plans, and delegates to the team.</p>
<h3 data-i18n="d_c_director_h">The Director</h3>
<p data-i18n="d_c_director_p">main is Claude itself — the office manager who answers you, creates projects, and routes work with DELEGATE lines.</p>
<h3 data-i18n="d_c_ghost_h">Ghosts (sub-agents)</h3>
<p data-i18n="d_c_ghost_p">When a job parallelizes, an agent splits into translucent clones that work on the Ghost Deck and merge back with a synthesis.</p>
<h3 data-i18n="d_c_grid_h">The room grid</h3>
<p data-i18n="d_c_grid_p">The floor is a 3×3 jigsaw of identical rooms; any room fits any slot, so you can rearrange the whole office in the editor.</p>
<h2 id="install-win" data-i18n="d_install_h">Installation</h2>
<div class="note" data-i18n="d_install_plat">Platform support: Windows 11 (stable, wallpaper embedding uses the WorkerW technique), macOS 13+ (beta, DYLD shim), and Linux (experimental — X11 EWMH desktop attach; Wayland falls back to a fullscreen window pinned below).</div>
<h3 data-i18n="d_install_win_h">Windows — one-shot installer (recommended)</h3>
<p data-i18n="d_install_win_p">Open PowerShell and run the command below — this is the recommended, most reliable path. It installs the dependencies (Git, Node LTS, Godot 4.6.3, Claude Code CLI) and downloads a prebuilt app, so a normal install needs no Visual Studio C++ Build Tools or Rust (those are only a source-build fallback). It clones the app to %LOCALAPPDATA%\BagIdeaOffice, brands the window icon, adds bagidea to your PATH, and creates a Start Menu shortcut. Safe to re-run — each step skips what's already done. No winget? It still works (Git and Node download directly).</p>
<pre><code>irm https://raw.githubusercontent.com/bagidea/bagidea-office/main/installer/install.ps1 | iex</code></pre>
<h3 id="install-mac" data-i18n="d_install_mac_h">macOS — one-shot installer (beta)</h3>
<p data-i18n="d_install_mac_p">Open Terminal and run the command below. It installs the dependencies (Git, Node, Rust, Godot, Claude Code CLI), clones the app to ~/BagIdeaOffice, builds the desktop shell and the wallpaper-embed shim, wires the Claude hooks, and sets up the bagidea command. Safe to re-run.</p>
<pre><code>curl -fsSL https://raw.githubusercontent.com/bagidea/bagidea-office/main/installer/install-mac.sh | bash</code></pre>
<h3 id="install-linux" data-i18n="d_install_lin_h">Linux — one-shot installer (experimental 🧪)</h3>
<p data-i18n="d_install_lin_p">Ubuntu/Debian (apt) for now. Open a terminal and run the command below. It installs the dependencies (Node 20, Rust, Git, WebKitGTK, GTK, wmctrl/xdotool, PulseAudio utils, Godot 4.6.3), builds the desktop shell, wires the Claude hooks, symlinks bagidea into ~/.local/bin, and adds an XDG autostart entry. On X11/Xorg the office attaches as the real desktop wallpaper; on Wayland it falls back to a fullscreen window pinned below everything. Please report problems with your distro, desktop, and the output of "echo $XDG_SESSION_TYPE".</p>
<pre><code>curl -fsSL https://raw.githubusercontent.com/bagidea/bagidea-office/main/installer/install-linux.sh | bash</code></pre>
<h3 data-i18n="inst_npx_h">Prefer npm? (optional)</h3>
<p data-i18n="inst_npx_p">Already have Node? This is just a thin wrapper that runs the same one-shot installer for your platform — no need to run both.</p>
<pre><code>npx bagidea</code></pre>
<h3 id="install-manual" data-i18n="d_install_manual_h">Manual build</h3>
<p data-i18n="d_install_manual_p">Clone the repository, point the Claude hook paths at your clone, then build the Rust shell:</p>
<pre><code>git clone https://github.com/bagidea/bagidea-office.git
cd bagidea-office\shell
cargo build --release # → shell/target/release/bagidea-office-shell.exe</code></pre>
<h3 id="install-first" data-i18n="d_install_first_h">First run</h3>
<p data-i18n="d_install_first_p">Log in to Claude once, then start the office. Your wallpaper becomes the live office; a chat head and tray icon appear.</p>
<pre><code>claude # sign in (first time only)
bagidea start # launch the office</code></pre>
<h3 id="install-fix" data-i18n="d_install_fix_h">If the install fails</h3>
<p data-i18n="d_install_fix_p">The installer is built to finish on a bare machine, but here are the common snags and their fixes. Almost all are solved by opening a NEW terminal and re-running the installer — re-runs are safe and keep your data.</p>
<ul class="fixlist">
<li data-i18n-html="d_install_fix_l1"></li>
<li data-i18n-html="d_install_fix_l2"></li>
<li data-i18n-html="d_install_fix_l3"></li>
<li data-i18n-html="d_install_fix_l4"></li>
<li data-i18n-html="d_install_fix_l5"></li>
<li data-i18n-html="d_install_fix_l6"></li>
</ul>
<h2 id="chat" data-i18n="d_using_h">Using it</h2>
<h3 data-i18n="d_chat_h">Chat & the CEO</h3>
<p data-i18n="d_chat_p">The chat panel opens on your CEO seat. Type an order in the CEO seat and the Director walks over to take it, plans, and delegates — you watch the hand-offs on the wallpaper, and the summary is walked back to you. To talk to any agent directly, click their face in the rail or on the live map. Every conversation is a resumable thread with full history.</p>
<img src="img/overlay.png" alt="The chat overlay">
<h3 id="projects" data-i18n="d_projects_h">Projects</h3>
<p data-i18n="d_projects_p">Register real folders as projects (with PLACE shorthands like "classroom → D:\Learning"). The Director can create new projects himself and route work into them; the assignee's Claude session runs inside that directory and is resumable. One occupant at a time: while an agent works a project you can't open it (a ⏹ stop-agent button with a two-click confirm lets you take over), and while you have it open an agent won't enter.</p>
<img src="img/projects.png" alt="The projects panel">
<img src="img/org.png" alt="The auto org chart">
<p data-i18n="d_org_p">The whole roster arranges itself into an org chart (🗂 → ORG): CEO → Director → mid → staff. Hire from ⚙ → AGENTS: name, role, avatar + aura, tier, a Persona Copilot that fills the prompt and picks fitting skills + tools, one of 16 voices, and the exact tools each agent may run.</p>
<h3 id="security" data-i18n="d_security_h">Permissions</h3>
<p data-i18n="d_security_p">Tools you grant in an agent's profile run silently — and the agent never even leaves its desk. For anything else, the agent walks to the Security Center and waits while a card pops up with the exact command. Choose Allow, ✓✓ Forever (remembers the grant), or Deny. No answer in 50 seconds auto-denies and the agent re-plans.</p>
<h3 id="editor" data-i18n="d_editor_h">The 3D Editor</h3>
<p data-i18n="d_editor_p">Open the editor (the 🎨 button or bagidea editor) to rearrange the office in true 3D: click two rooms to swap them on the 3×3 grid, move the Ghost Deck, place furniture and decor, and import your own .glb/.gltf/.fbx models and images. Save and the wallpaper updates instantly — furniture, agent seats, navigation and pets all follow.</p>
<img src="img/editor.png" alt="The 3D Office Editor">
<h3 id="voice" data-i18n="d_voice_h">Voice & channels</h3>
<p data-i18n="d_voice_p">Hold Right Ctrl anywhere to speak a command to the office. Give agents one of 16 TTS voices (split clearly ♀/♂). Call the main agent for a realtime voice conversation (Gemini Live) in its assigned voice. Connect Telegram, Discord, LINE, Slack, WhatsApp or Messenger and command your office from your phone — replies come back on the same channel.</p>
<h3 id="updates" data-i18n="d_updates_h">Updates & start-up</h3>
<p data-i18n="d_updates_p">A VERSION file marks real releases: the office only shows the 🔄 update banner when main's version is newer than yours, so routine commits never nag you. Click the banner or run bagidea update to pull, rebuild and relaunch (your data is kept). Set it to launch with Windows from the tray, settings, or bagidea startup on.</p>
<h2 id="brains" data-i18n="d_brain_h">Swappable brains (any model)</h2>
<p data-i18n-html="d_brain_p">Run each agent on its own model. Claude Code stays the engine — only the brain behind it swaps, and it fails open to Claude, so nothing changes until you opt an agent in. <b>No LiteLLM or Python to install</b> — a translation proxy is built into the daemon.</p>
<ul>
<li data-i18n-html="d_brain_direct"><b>Direct (Anthropic-compatible):</b> Claude · GLM (Z.AI) · DeepSeek · Qwen (Alibaba) · MiniMax · Kimi (Moonshot)</li>
<li data-i18n-html="d_brain_proxy"><b>Via the built-in proxy (OpenAI-compatible):</b> OpenAI · Gemini · OpenRouter · NVIDIA · Groq · Cerebras · xAI (Grok) · Mistral · Together · Fireworks — plus <b>local Ollama / LM Studio with no API key</b>. Pickers fetch each provider's live model list.</li>
<li data-i18n-html="d_brain_custom"><b>Custom providers:</b> add your own — name + Base URL + key, Anthropic- or OpenAI-style (point it at a LiteLLM gateway if you run one).</li>
</ul>
<img src="img/brains-connect.png" alt="Connect providers in CONNECT → MODELS/PROVIDERS">
<img src="img/swappable-brains.png" alt="Pick a provider and model per agent, with a context-usage meter">
<p data-i18n-html="d_brain_setup"><b>Set it up:</b> ⚙ CONNECT → 🧠 MODELS/PROVIDERS → paste a key → Connect (✅). Then ✏️ edit an agent → 🧠 Brain → pick provider + model (a working default is auto-selected) → Save.</p>
<p data-i18n-html="d_brain_free"><b>Free to try, with limits:</b> NVIDIA build is free but rate-limited (~40 req/min); OpenRouter has free <code>:free</code> models that are daily-capped (use <code>vendor/model</code> ids); Gemini has a generous free quota; OpenAI Tier 1 (30k tokens/min) is small for heavy agent work.</p>
<p data-i18n-html="d_brain_compact"><b>Auto-compact + auto-new-thread — for every model.</b> Long chats never clog: before each turn the office measures the thread against the model's context window and, if it's filling up, summarizes it with Claude and continues on a fresh thread — recovering the same way if a backend rejects a too-big request. Continuity is preserved (the summary is Claude-written) and the view follows you to the new thread.</p>
<p data-i18n-html="d_brain_monitor"><b>Monitor it:</b> every message is tagged with its model, the thread bar shows a live context meter (e.g. <code>gpt-4o · 40k/128k</code>), the 🧠 BRAINS panel tracks every provider + agent, and STATS estimates per-provider spend.</p>
<img src="img/brains-chat.png" alt="Chat tagged with the model and a context-usage meter in the thread bar">
<h2 id="plugins" data-i18n="d_plugins_h">Plugins, skills & tools</h2>
<p data-i18n="d_plugins_p">Plugins extend the office for real — a folder with a manifest can add UI panels, HTTP routes, and commands agents can drive, with ctx access to the registry, feed, broadcasting and even running Claude turns. Two core plugins ship in the box (🎵 Music Player, 🧮 Calculator); install more from any GitHub repo. Start from the official template, or read the worked example repos.</p>
<img src="img/plugins.png" alt="The plugins panel listing installed plugins, with install-from-GitHub">
<img src="img/briefing.png" alt="A morning briefing rendered inside a plugin panel">
<pre><code>bagidea plugin install https://github.com/bagidea/bagidea-office-template</code></pre>
<p data-i18n="d_skills_p">Every office ships with a library of builtin skills (deep research, office control, plugin building, code review, docs, debugging, data wrangling, project kickoff, diagrams) you can assign to any agent, plus Hermes-style skills the office learns automatically after real work. Add new raw capability via MCP servers.</p>
<h2 id="workflow" data-i18n="d_wf_h">Workflow Builder</h2>
<p data-i18n="d_wf_p">Plan work as plain-language nodes on a drag-drop canvas (⋯ menu → Workflow Builder) — each node is a step (trigger / fetch / action / decision / output) and the flow reads top to bottom. Press <b>Analyze</b> and the Director reads your plan and tells you which skills and tools it needs, what permissions or extra agents to add, and what's still undecided — so you can plan work even if you don't know how to instruct it, and let the team work out the execution.</p>
<ol>
<li data-i18n-html="d_wf_1"><b>Add nodes & write in plain language.</b> e.g. “every morning summarize AI news, then send it to Telegram”. Drag cards to order the flow top→bottom.</li>
<li data-i18n-html="d_wf_2"><b>Analyze.</b> The Director returns a plan: needed skills/tools, permissions/agents to set up, and open questions. (This release plans only — it doesn't auto-run yet.)</li>
<li data-i18n-html="d_wf_3"><b>Save & reuse.</b> Workflows are stored under workspace/workflows. Three example workflows ship in the box to learn from.</li>
</ol>
<h2 id="lang" data-i18n="d_lang_h">Languages</h2>
<p data-i18n="d_lang_p">The whole interface supports 14 languages. English is the default; pick another in settings and the office translates office-wide (and remembers your choice per machine). This website speaks the same 14 languages — use the picker in the top bar.</p>
<p><span class="tag">en</span> <span class="tag">ไทย</span> <span class="tag">中文</span> <span class="tag">Español</span> <span class="tag">हिन्दी</span> <span class="tag">العربية</span> <span class="tag">Português</span> <span class="tag">Русский</span> <span class="tag">日本語</span> <span class="tag">Deutsch</span> <span class="tag">Français</span> <span class="tag">한국어</span> <span class="tag">Indonesia</span> <span class="tag">Tiếng Việt</span></p>
<h2 id="sponsors" data-i18n="d_sponsors_h">Sponsoring</h2>
<p data-i18n="d_sponsors_p">BagIdea Office is free and open source; sponsorship funds development, art licenses and cross-platform backends. It is a recurring monthly subscription run entirely by GitHub Sponsors (like a YouTube or Patreon membership) — secure payments, tax and payouts are GitHub's job, not ours. Four monthly tiers: 💛 Supporter ($5), 🥉 Bronze / Backer ($30), 🥈 Silver Partner ($300), 👑 Gold Partner ($3,000).</p>
<ol>
<li data-i18n-html="d_sponsors_1"><b>Choose a tier & sponsor.</b> Use the “💖 Sponsor on GitHub” button on the site (or github.com/sponsors/bagidea), pick a monthly tier, and confirm — GitHub charges you each month until you cancel.</li>
<li data-i18n-html="d_sponsors_2"><b>Your logo & link come from your GitHub profile — automatically.</b> Your avatar, display name and link are pulled straight from your GitHub account; there is nothing to send us. To control the link, set the <b>Website</b> field in your GitHub profile (Settings → Public profile). Sponsoring as a GitHub Organization shows your company logo and site.</li>
<li data-i18n-html="d_sponsors_3"><b>You appear within ~6 hours.</b> As long as you choose “Make my sponsorship public” at checkout, an automated workflow pulls the live list, maps each sponsor to a tier by amount, and updates the supporters wall on the website and the README — sorted by tier, amounts never shown. Private sponsors are respected and not listed.</li>
</ol>
<p class="muted" data-i18n="d_sponsors_note">Everyone joins through GitHub Sponsors. The only exceptions are featured partners added by hand (e.g. WARRIX, pinned first); Reuannamphung is shown as a courtesy until they move to GitHub Sponsors.</p>
<h2 id="cli" data-i18n="d_cli_h">CLI reference</h2>
<p data-i18n="d_cli_p">The installer puts bagidea on your PATH. It talks to the running office and can start it. A few highlights:</p>
<table>
<tr><th>Command</th><th>Does</th></tr>
<tr><td><code>bagidea start | stop | restart</code></td><td>Launch / stop / restart the whole suite</td></tr>
<tr><td><code>bagidea status</code></td><td>Health + agents + projects + who's working</td></tr>
<tr><td><code>bagidea stats</code></td><td>Dashboard: runs / cost / busiest / uptime</td></tr>
<tr><td><code>bagidea ask "<message>"</code></td><td>Order the Director and wait for the final answer</td></tr>
<tr><td><code>bagidea chat <agent> "<msg>"</code></td><td>Hand a task to a specific agent (fire-and-forget)</td></tr>
<tr><td><code>bagidea agents · projects</code></td><td>List staff / projects with live status</td></tr>
<tr><td><code>bagidea open "<project>"</code></td><td>Open a project window (same as ▶)</td></tr>
<tr><td><code>bagidea proposals</code></td><td>Team project pitches awaiting a verdict</td></tr>
<tr><td><code>bagidea proposal show <id></code></td><td>Read a pitch in full</td></tr>
<tr><td><code>bagidea proposal approve|reject <id> [note]</code></td><td>Decide on a pitch (+ optional note to the team)</td></tr>
<tr><td><code>bagidea plugins</code></td><td>List installed plugins</td></tr>
<tr><td><code>bagidea plugin install <git-url> · remove <id></code></td><td>Add / remove a plugin</td></tr>
<tr><td><code>bagidea lang <code></code></td><td>Show / set the office language (14 languages)</td></tr>
<tr><td><code>bagidea say "<text>" · voices</code></td><td>Speak via TTS · list voice presets</td></tr>
<tr><td><code>bagidea image "<prompt>"</code></td><td>Generate an AI image into the office</td></tr>
<tr><td><code>bagidea channels · keys</code></td><td>Channel + API-key status</td></tr>
<tr><td><code>bagidea feed</code></td><td>Live office event stream in your terminal</td></tr>
<tr><td><code>bagidea startup [on|off]</code></td><td>Launch the office with Windows (show / set)</td></tr>
<tr><td><code>bagidea update · version</code></td><td>Update to the latest release · show current version</td></tr>
<tr><td><code>bagidea --help · --version</code></td><td>Full command list / current build</td></tr>
</table>
<img src="img/cli.png" alt="bagidea CLI help">
<h2 id="faq" data-i18n="d_faq_h">FAQ</h2>
<h3 data-i18n="d_faq_q1">Does it cost money to run?</h3>
<p data-i18n="d_faq_a1">The app is free and open source (MIT). Agents run through your own Claude Code login, so usage follows your existing Claude account or subscription — there is no separate BagIdea fee.</p>
<h3 data-i18n="d_faq_q2">Is my code/data sent anywhere?</h3>
<p data-i18n="d_faq_a2">The daemon runs locally on 127.0.0.1. Agents are Claude Code sessions, so they use Claude like any Claude Code project. Optional features (voice, image, realtime) use your own OpenAI/Gemini keys only when you enable them.</p>
<h3 data-i18n="d_faq_q3">Which platforms are supported?</h3>
<p data-i18n="d_faq_a3">Windows 11, macOS 13+ (beta), and Linux (experimental) today.</p>
<h3 data-i18n="d_faq_q4">Can I build my own plugin?</h3>
<p data-i18n="d_faq_a4">Yes — fork the official template repo. A person or an agent can build a working plugin from it in minutes; the full spec is in the plugin guide.</p>
</main>
</div>
<footer>
<div class="wrap">
<div class="copyright" data-i18n="copyright">© 2026 BagIdea Innovation Co., Ltd. · MIT-licensed open source.</div>
</div>
</footer>
<a href="#" class="toplink" aria-label="Back to top">↑</a>
<script>
const topBtn = document.querySelector(".toplink");
addEventListener("scroll", () => topBtn.classList.toggle("show", scrollY > 600));
// highlight the active doc section in the sidebar
const links = [...document.querySelectorAll(".docnav a[href^='#']")];
const map = links.map((a) => ({ a, el: document.querySelector(a.getAttribute("href")) })).filter((x) => x.el);
addEventListener("scroll", () => {
let cur = map[0];
for (const m of map) if (m.el.getBoundingClientRect().top <= 90) cur = m;
links.forEach((a) => a.classList.toggle("active", cur && a === cur.a));
});
</script>
</body>
</html>