avibe-os 3.0.0a0__tar.gz

avibe_os-3.0.0a0/.gitignore

@@ -0,0 +1,181 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.e2e
+.env.three-regression
+.env.*.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# Project specific
+*.log
+claude_proxy.log
+demolog.log
+_tmp/
+.runtime/
+.DS_Store
+logs/
+.vibe_remote/
+ui/node_modules/
+ui/dist/
+ui/.vite/
+vibe/show_runtime/*.tgz
+tmp/
+.bot.pid
+user_settings.json
+vibe/_version.py
+
+# Config files with secrets
+config/secrets.py
+config/local_settings.py
+
+# Session data
+sessions/
+*.session
+
+# Temporary files
+*.tmp
+*.bak
+*.swp
+*~
+
+# Worktrees
+.worktrees/
+.gstack/

avibe_os-3.0.0a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Vibe Remote Authors
+
+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.

avibe_os-3.0.0a0/PKG-INFO

@@ -0,0 +1,481 @@
+Metadata-Version: 2.4
+Name: avibe-os
+Version: 3.0.0a0
+Summary: Local-first Agent OS for Web and IM agent workflows
+Project-URL: Homepage, https://github.com/avibe-bot/avibe
+Project-URL: Repository, https://github.com/avibe-bot/avibe
+Project-URL: Documentation, https://github.com/avibe-bot/avibe#readme
+Project-URL: Issues, https://github.com/avibe-bot/avibe/issues
+Author-email: cyhhao <cyhhao@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,agent-os,ai,automation,chatops,claude-code,codex,discord,feishu,lark,opencode,slack,telegram,vibe-coding,wechat
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: aiohttp-socks>=0.8.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: alembic>=1.13.0
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: apscheduler>=3.10.4
+Requires-Dist: claude-agent-sdk>=0.1.66
+Requires-Dist: discord-py>=2.4.0
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx[socks]>=0.27
+Requires-Dist: imagesize>=1.4.1
+Requires-Dist: lark-oapi>=1.4.0
+Requires-Dist: markdown-to-mrkdwn>=0.2.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pyjwt[crypto]>=2.9.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: python-socks[asyncio]>=2.0.0
+Requires-Dist: pywebpush>=2.0.3
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: sentry-sdk>=2.0.0
+Requires-Dist: slack-sdk>=3.26.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: uvicorn[standard]>=0.27
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="assets/logo.png" alt="Vibe Remote" width="120"/>
+
+# Vibe Remote
+
+### Your AI colleagues, present in Slack, Discord, Telegram, WeChat & Lark.
+
+**No laptop. No IDE. Just vibes.**
+
+[![GitHub Stars](https://img.shields.io/github/stars/cyhhao/vibe-remote?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/cyhhao/vibe-remote/stargazers)
+[![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?labelColor=black&style=flat-square)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green?labelColor=black&style=flat-square)](LICENSE)
+
+<a href="https://www.producthunt.com/products/vibe-remote?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-vibe-remote" target="_blank" rel="noopener noreferrer"><img alt="Vibe Remote - Code from your phone — AI agents in your chat app | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1104967&theme=light&t=1774450119248"></a>
+
+[Docs](https://docs.avibe.bot) | [English](README.md) | [中文](README_ZH.md)
+
+**Supported Platforms**
+
+![Slack](https://img.shields.io/badge/Slack-4A154B?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACMAAAAiCAYAAADVhWD8AAACT0lEQVR42s2VQW7bMBBFfQQdoDa47CIiBBSuu/QRvCpid1HdwNrHjnUDH4Ww0irdCWjtZukjMF0ViGOM0wuoZJRkCFkUJZmIMsAHLXNAPo5Gn506Mdg8TD9uDlwofRxv/n3N59Afl1Maz0EoFeI0vsQcW9Ffgy8h8hr8huAF5Hq2kBB5WQfCihwJnnNkJYphZlvbMKlOXgKOdx2SYwiUbRjQwXy6AfKqMIM1BO3DqNX5BSH2TqswGHJzVfI/6zC4kVkdJZrAEBY6HguJ1tD6a2zSMqHpPSyawNB4sdQYIxpafaHpmWEQpGj+7OpimMFsDtvaICioCuOx0NHNu/E8QUMzyIbpeeL0JTn86TUdkhNguHIdgO46QBhDZT78hFFjGHlzI0yguyhLYbBnsIn761q9w6Urd3Lhfp/7eGHK8SLL0cC48SxBkLca3Bk5nJwTVbqcsnWAEecv80gFFa/zpzeZ3va+wG1vkqqSGys5CzVHPufX2Ud0eR9REEqraBdRvr+iuA7vTnwEOIZBkIL53jjIgaSN9I1mH4I47dYEI35zTQ48wzSBQLlJBoMLF8Jw4jtlOXIN+f5PgRFV5RlMd5yUnVoClcJgZeDkyvB358PifpiEdWDuIho0hdmxs6HSxOORUiGOjVkZJgNirn+/otuKECArgiDmMMNYCOswO+YNVQF7T1qA0X9N+8hdtg6jareiYfswqofYChum17EZYlPNlTHmBtNDQ7MQ6ENFxtj9PDKZ3h3zPJss6NSZMXI5ymecRdOTldivKBcjqwPyH3MZonz6I6ghAAAAAElFTkSuQmCC)
+![Discord](https://img.shields.io/badge/Discord-5865F2?style=flat-square&logo=discord&logoColor=white)
+![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=flat-square&logo=telegram&logoColor=white)
+![WeChat](https://img.shields.io/badge/WeChat-07C160?style=flat-square&logo=wechat&logoColor=white)
+![Lark](https://img.shields.io/badge/Lark%20%2F%20Feishu-3370FF?style=flat-square&logo=bytedance&logoColor=white)
+
+**Supported Agents**
+
+![Claude Code](https://img.shields.io/badge/Claude%20Code-D4A27F?style=flat-square&logo=anthropic&logoColor=white)
+![OpenCode](https://img.shields.io/badge/OpenCode-00B4D8?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAzMCIgZmlsbD0ibm9uZSI+PHBhdGggZD0iTTE4IDZINlYyNEgxOFY2Wk0yNCAzMEgwVjBIMjRWMzBaIiBmaWxsPSIjZmZmIi8+PC9zdmc+)
+![Codex](https://img.shields.io/badge/Codex-412991?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAIKADAAQAAAABAAAAIAAAAACshmLzAAAEHklEQVRIDe2VWSitbRTHDyGZZ5EhQyJTxgwhKVOZM4QLuSCSqXBDUS5wQZkuSUSZbkw3KKSMhSJCCZmnEJnP7+s9Obt3s/f39XXuzlN7t571rLX+z7PWf61X4ePj48efXIp/Mvg/sf8CyM2wklwLDI6Ojubm5k5PTy0sLPz8/HR1df+N1y8bWCRjvb29VVdX6+npGRoaWltba2trW1patrW1HR4eLi8vb21tPT8/y3Dn6Ifs44KCAgMDg66urqurq/f39/Pz86SkJK6mo6OjoaGhpqbm6OjY2dkpI4gsgJmZGVVV1YWFBcGfW+fm5urr6ycnJ4+Pj+/u7pK3wsJCJSWl8vLy7zC+Bbi5uYmNjU1MTMTz/v6+vr6ep7i5uY2NjYli9fT08CYgRXph+zVAb2+vubk5bg0NDdjl5+draWk1NTW9vLywXVlZCQsLc3BwGBgYEKJERERERUUJsuj/i0br7+9PTU1NSUmxt7enyMDs7OyQlry8vOvr69LS0pCQEJT+/v7p6emRkZEbGxsJCQlra2vAoxcvESDFNDY2LisrQ09C6urqEKKjozMyMtrb201MTPDnsgJ5lpaWQkNDoZaXl5eTkxO3EUVjK05RX18fDpeXl5y5uroKALxGWVnZyMiotraWYpiZmfn6+k5MTAjhcLGzsyOlJycn8gEqKyu5uGAHAOGQ4+Li6K/9/X1BjxAQEMBTAN7e3kZ5cXHh6enJy6QfIa4Bxby7u4Py+L++vpJZoQyACWVHj8AlnJ2d6W0fH5+Wlha429raCsHoPgwklxggMDBwb29vcXERI8gzPDwcFBTENUmRpBv1tLW1JUvwuLGxkSMPDw8rKytaR9IMWQzg7u7OS3Nycs7OzrKysubn53FbX1+nngALzggwFVlBQYFOFrAVFRXpbV4v2Pz+F9Iq+U9ohhqThw4S9FNTUyTd1NS0pqaG0cRcUlFRgbic0ihgIMAL2AHFJUMhi1mEiqTDOW9vbwZOcHAw8wAlvORl3IsCMJoyMzPhLnoAKAZCSUkJN6BRkCWXOEWEoMLMhuzsbPJDzcGgCcLDw0GqqKhYXV1NS0sjIVAAY4THx8fi4mKQaHXu9Ds5giSJ9inHxMTQosJ2ZGQEzjCX6Fg0T09PxNLU1CwqKmLb3NxMHOo0ODj46S4pfJEijicnJ7lad3e3pCny0NAQCaHVuezDwwMaWiE+Pp7aiiw/t18DcFxVVQU9mM/T09Obm5ujo6MEYqDC3ePjY8GfSc4nYXZ29jOctPAtAKawyMXFRV1dHf4Jn0mGGvOAJuDL09HRAR7Zlw4qqZEFgB2VZJRSWOJCHhsbG8rOV5PWhaywVno2SEZHVuAnrvv3+9vbW7h0cHDA4IPHFON7218n/w1Abjhpgy/6QNro/2j+AsjN3k91TuJWs4eHugAAAABJRU5ErkJggg==)
+
+---
+
+![Banner](assets/banner.jpg)
+
+</div>
+
+## The Pitch
+
+You're at the beach. Phone buzzes — production's on fire.
+
+**Old you:** Panic. Find WiFi. Open laptop. Wait for IDE. Lose your tan.
+
+**Vibe Remote you:** Open Slack, Discord, Telegram, or WeChat. Type "Fix the auth bug in login.py". Watch Claude Code fix it in real-time. Approve. Sip margarita.
+
+```
+AI works. You live.
+```
+
+---
+
+## Install in 10 Seconds
+
+```bash
+curl -fsSL https://avibe.bot/install.sh | bash && vibe
+```
+
+Open source — view the [script on GitHub](https://github.com/cyhhao/vibe-remote/blob/master/install.sh). The short URL is a 307 redirect to that file.
+
+That's it. Browser opens -> Follow the wizard -> Done.
+
+Need to open the Web UI from another device or a remote server? Run:
+
+```bash
+vibe remote
+```
+
+<details>
+<summary><b>Windows?</b></summary>
+
+We recommend the WSL setup on Windows because it has the best compatibility.
+
+- Recommended: [Run Vibe Remote with WSL from Scratch](docs/WINDOWS_WSL.md)
+
+If you are new to WSL, this guide explains:
+- where to install WSL
+- which terminal window to use
+- where to run the Vibe Remote install command
+- how to launch Ubuntu and open the Web UI
+</details>
+
+---
+
+## What Ships Today
+
+Not an agent framework. Not a hosted coding VM. Vibe Remote is the local-first way to bring the AI agents already running on your machine into the chat apps where you already collaborate.
+
+- **Chat apps become collaboration spaces:** Slack, Discord, Telegram, WeChat, and Lark / Feishu.
+- **Real agents, no middleman:** Today's first-class backends are Claude Code, OpenCode, and Codex.
+- **Thread = session:** Start five threads, run five isolated agent jobs, resume later.
+- **Web setup, not token archaeology:** Local wizard, dashboard, routing, and health checks.
+- **Remote UI when you need it:** `vibe remote` opens your local Web UI through a secure avibe.bot tunnel.
+- **Walk away without losing the loop:** Completion notifications and the Agent Harness keep work moving while you live your life.
+
+---
+
+## Why This Exists
+
+| Problem | Solution |
+|---------|----------|
+| Claude Code is amazing but lives in a terminal | Slack/Discord/Telegram/WeChat/Lark can become the collaboration surface |
+| Context-switching kills flow | Stay in one app |
+| Start on desktop, continue on phone | Resume the exact agent session from the current project in seconds |
+| Can't code from phone | Yes you can |
+| Multiple agents, multiple setups | One chat app, any agent |
+
+**Supported Agents:**
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — Deep reasoning, complex refactors
+- [OpenCode](https://opencode.ai) — Fast, extensible, community favorite  
+- [Codex](https://github.com/openai/codex) — OpenAI's coding model
+
+---
+
+## Meet Vibey
+
+<div align="center">
+<img src="assets/mascot/cloud-tuanzi.png" alt="Vibey — the gaseous consciousness inside Vibe Remote" width="220"/>
+</div>
+
+Lives in your Slack, Discord, Telegram, Lark, or WeChat. Reads the room. Picks up where you left off. Asks the right question when it's not sure. Goes quiet when you're heads-down. Ships at 2am because that's when the vibe hits — then leaves a note about what it touched.
+
+> Vibe Remote is the wire. Vibey is the colleague on the other end.
+
+Forgets nothing. Holds opinions. Says thanks when you fix its bugs.
+
+---
+
+## Why Vibe Remote over OpenClaw?
+
+| | Vibe Remote | OpenClaw |
+|---|---|---|
+| **Setup** | One command + web wizard. Done in 2 minutes. | Gateway + channels + JSON config. Expect an afternoon. |
+| **Security** | Local-first. Socket Mode / WebSocket only. No public endpoints, no inbound ports, minimal attack surface. | Gateway exposes ports. More moving parts, more attack surface. |
+| **Token cost** | No extra reasoning loop in the middleware. Tokens go to your chosen agent, not to a second assistant layer. | Every message carries a long system context for maintaining agent persona, IM tooling, and orchestration plumbing. Tokens burn on overhead before your actual task even starts. |
+
+OpenClaw is a personal AI assistant — great for casual chat, but its always-on agent loop makes it expensive for real productivity workloads. Vibe Remote is not an agent framework. It is a **local-first collaboration runtime** for the AI agents you already trust: the agent stays itself, your data stays local, and the colleague experience comes from putting the agent into the same communication flow where human work already happens. Coding is the first strong workload, not the product boundary. Every token goes straight to your task.
+
+---
+
+## Highlights
+
+<table>
+<tr>
+<td width="33%">
+
+### Setup Wizard
+
+One-command install, guided configuration. No manual token juggling.
+
+![Setup Wizard](assets/screenshots/setup-slack-en.png)
+
+</td>
+<td width="33%">
+
+### Dashboard
+
+Real-time status, health monitoring, and quick controls.
+
+![Dashboard](assets/screenshots/dashboard-en.png)
+
+</td>
+<td width="33%">
+
+### Channel Routing
+
+Per-channel agent configuration. Different projects, different agents.
+
+![Channels](assets/screenshots/channels-en.png)
+
+</td>
+</tr>
+</table>
+
+### Instant Notifications
+
+Get notified the moment your AI finishes. Like assigning tasks to employees — delegate, go do something else, and come back when the work is done. No need to babysit.
+
+### Thread = Session
+
+Each Slack/Discord/Telegram/WeChat/Lark chat scope is an isolated workspace. Open 5 chats, run 5 parallel tasks. Context stays separate.
+
+### Resume Anywhere
+
+Laptop closed. Commute started. Production still needs you.
+
+Vibe Remote lets you reopen real agent sessions from your current working directory across Claude Code, OpenCode, and Codex. Pick the latest session, jump from desktop to mobile, and keep going without re-explaining the task, hunting for an old thread, or losing the thread of thought.
+
+### Interactive Prompts
+
+When your agent needs input — file selection, confirmation, options — your chat app pops up buttons or a modal. Full CLI interactivity, zero terminal required.
+
+![Interactive Prompts](assets/screenshots/question-en.jpg)
+
+---
+
+## Harness
+
+Vibe Remote gives agents a real harness: a small set of durable tools they can combine to work on their own timeline, more like a colleague than a command you have to babysit.
+
+Think of it like giving your AI colleague a task board, a calendar, and a notification center:
+
+- `vibe agent run` starts one concrete Agent Run. It can be synchronous when you want an answer now, or async when the agent should keep working in the background.
+- `vibe task` saves time-based work: "run this every morning", "remind me tonight", "check this once after lunch".
+- `vibe watch` waits for the world to change: a PR review, CI result, deployment, file, log line, or long-running process.
+- `vibe runs` lets the agent inspect what happened, continue from a run, or cancel work when the situation changes.
+
+The important part is that you do not have to memorize all of that. Agents can learn these primitives and use them as building blocks.
+
+Ask in normal language:
+
+- "Watch this PR and come back when there is actionable review feedback."
+- "Run this deployment check every weekday morning and post the summary here."
+- "Start a separate investigation session for this incident, but report the conclusion to this channel."
+- "Kick off three background checks and keep track of their run IDs."
+- "If CI fails, summarize the logs; if it passes, tell me whether the PR is mergeable."
+
+That is the Harness: the agent can leave the current chat turn, wait, return, branch, retry, and keep records without inventing fragile shell scripts or making you poll manually.
+
+---
+
+## 📡 Your Machine, In Your Pocket — Powered by avibe.bot
+
+Your Vibe Remote runs on your machine. You don't sit in front of it 24/7.
+
+You're on a plane. At a café. Holding someone else's borrowed laptop. The bot just pinged you that a job needs attention — and the control panel is back home.
+
+```bash
+vibe remote
+```
+
+One command. Your local Web UI becomes reachable from any browser on Earth — through a secure avibe.bot tunnel.
+
+- 🌍 **Your own `you-app.avibe.bot`** — 30-second sign-in, your slug for life
+- 🔒 **Fail-closed at every join** — Auth, routing, host checks default to "deny"
+- 📱 **Mobile-aware UI** — Thumb-friendly layout, designed for borrowed screens
+- ⏱ **24-hour sessions** — Cookie auto-renews mid-session, no sudden logouts
+
+No VPN. No port forwarding. No "wait what's my IP again." No public webhooks pointed at your laptop. **Your data plane stays on your machine**; avibe.bot is just the control-plane handshake.
+
+> Your agents work on your machine. You command them from your pocket.
+
+→ [Set it up in 60 seconds](docs/CLI.md)
+
+---
+
+## How It Works
+
+```
+┌──────────────┐             ┌──────────────┐             ┌──────────────┐
+│     You      │   Slack     │              │   stdio     │  Claude Code │
+│  (anywhere)  │   Discord   │ Vibe Remote  │ ──────────▶ │  OpenCode    │
+│              │   Telegram  │ (your host)  │ ◀────────── │  Codex       │
+│              │   WeChat    │              │             │              │
+│              │   Lark      │              │             │              │
+└──────────────┘             └──────────────┘             └──────────────┘
+```
+
+1. **You type** in Slack/Discord/Telegram/WeChat/Lark: *"Add dark mode to the settings page"*
+2. **Vibe Remote** routes to your configured agent
+3. **Agent** reads your codebase, writes code, streams back
+4. **You review** in your chat app, iterate in thread
+
+**Your data never leaves your machine.** Vibe Remote runs locally and connects via Slack Socket Mode, Discord Gateway, Telegram Bot API long polling, WeChat polling, or Lark WebSocket.
+
+---
+
+## Commands
+
+| In chat | What it does |
+|----------|--------------|
+| `@Vibe Remote /start` | Open control panel |
+| `/stop` | Kill current session |
+| Just type | Talk to your agent |
+| Reply in thread | Continue conversation |
+
+**Pro tip:** Each thread = isolated session. Start multiple threads for parallel tasks.
+
+Detailed references:
+
+- [Full Command Reference](docs/COMMANDS.md)
+- [CLI Reference](docs/CLI.md)
+
+---
+
+## Instant Agent Switching
+
+Need a different agent mid-conversation? Just prefix your message:
+
+```
+Plan: Design a new caching layer for the API
+```
+
+That's it. No menus, no commands. Type `AgentName:` and your message routes to that agent instantly.
+
+---
+
+## Per-Channel Routing
+
+Different projects, different agents:
+
+```
+#frontend    → OpenCode (fast iteration)
+#backend     → Claude Code (complex logic)  
+#prototypes  → Codex (quick experiments)
+```
+
+Configure in web UI → Channels.
+
+---
+
+## CLI
+
+```bash
+vibe          # Start everything
+vibe status   # Check if running
+vibe stop     # Stop everything
+vibe doctor   # Diagnose issues
+vibe task     # Create and manage scheduled tasks
+vibe watch    # Manage background waiters
+vibe agent    # Manage and run Vibe Agents
+vibe runs     # Inspect Agent Run records
+```
+
+Detailed references:
+
+- [Full Command Reference](docs/COMMANDS.md)
+- [CLI Reference](docs/CLI.md)
+
+---
+
+## Prerequisites
+
+You need at least one coding agent installed:
+
+<details>
+<summary><b>OpenCode</b> (Recommended)</summary>
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+**Required:** Add to `~/.config/opencode/opencode.json` to skip permission prompts:
+
+```json
+{
+  "permission": "allow"
+}
+```
+</details>
+
+<details>
+<summary><b>Claude Code</b></summary>
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+</details>
+
+<details>
+<summary><b>Codex</b></summary>
+
+```bash
+npm install -g @openai/codex
+```
+</details>
+
+---
+
+## Security
+
+- **Local-first** — Vibe Remote runs on your machine
+- **Socket Mode / WebSocket** — No public URLs, no webhooks
+- **Your tokens** — Stored in `~/.vibe_remote/`, never uploaded
+- **Your data** — Stays on your disk, sent only to your chosen AI provider
+
+---
+
+## Uninstall
+
+```bash
+vibe stop && uv tool uninstall vibe-remote && rm -rf ~/.vibe_remote
+```
+
+---
+
+## Roadmap
+
+- [x] Slack support
+- [x] Discord support
+- [x] Telegram support
+- [x] WeChat support
+- [x] Lark (Feishu) support
+- [x] Web UI setup wizard & dashboard
+- [x] Per-channel agent routing
+- [x] Interactive prompts (buttons, modals)
+- [x] File attachments
+- [ ] SaaS Mode
+- [ ] Vibe Remote Coding Agent (one agent to rule them all)
+- [ ] Skills Manager
+- [ ] Best practices & multi-workspace guide
+
+---
+
+## Docs
+
+- **[Official Docs](https://docs.avibe.bot)** — Quickstart, platform guides, agent setup, troubleshooting, and AI-readable install instructions
+- **[CLI Reference](docs/CLI.md)** — Command-line usage and service lifecycle
+- **[Install via AI Agent](docs/INSTALL_FOR_AI.md)** — Give this to Claude Code, Codex, or OpenCode for guided setup
+- **[Incus Tenant Scaffold](docs/INCUS_TENANTS.md)** — Create isolated Vibe Remote tenants on one Incus host
+- **[Slack Setup Guide](docs/SLACK_SETUP.md)** — Detailed setup with screenshots
+- **[Discord Setup Guide](docs/DISCORD_SETUP.md)** — Detailed setup with screenshots
+- **[Telegram Setup Guide](docs/TELEGRAM_SETUP.md)** — BotFather setup, token validation, and chat discovery
+- **WeChat Setup Guide** — Follow the in-app wizard (`vibe` → choose WeChat)
+- **Lark Setup Guide** — Follow the in-app wizard (`vibe` → choose Lark)
+
+---
+
+<div align="center">
+
+**Stop context-switching. Start vibe coding.**
+
+[Install Now](#install-in-10-seconds) · [Setup Guide](docs/SLACK_SETUP.md) · [Report Bug](https://github.com/cyhhao/vibe-remote/issues) · [Follow @alex_metacraft](https://x.com/alex_metacraft)
+
+---
+
+*Built for developers who code from anywhere.*
+
+</div>