{"id":50718156,"url":"https://github.com/avibe-bot/avibe","last_synced_at":"2026-06-14T19:00:57.031Z","repository":{"id":309063857,"uuid":"1035030370","full_name":"avibe-bot/avibe","owner":"avibe-bot","description":"The local-first Agent OS — your AI partner lives on your own machine. Drive the official Claude Code, Codex \u0026 OpenCode from your browser or any chat app.","archived":false,"fork":false,"pushed_at":"2026-06-14T11:42:49.000Z","size":59835,"stargazers_count":468,"open_issues_count":4,"forks_count":67,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-14T13:15:37.522Z","etag":null,"topics":["agent","agent-os","ai","ai-agents","chatops","claude","claude-code","codex","devtools","discord-bot","lark-bot","llm","local-first","opencode","slack-bot","vibe-coding","wechat"],"latest_commit_sha":null,"homepage":"https://avibe.bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/avibe-bot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-09T14:04:57.000Z","updated_at":"2026-06-14T09:30:25.000Z","dependencies_parsed_at":"2025-08-09T17:24:41.717Z","dependency_job_id":"43adc772-f371-4400-bdc7-9740a29bac6f","html_url":"https://github.com/avibe-bot/avibe","commit_stats":null,"previous_names":["cyhhao/vibe-remote","avibe-bot/avibe"],"tags_count":89,"template":false,"template_full_name":null,"purl":"pkg:github/avibe-bot/avibe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avibe-bot%2Favibe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avibe-bot%2Favibe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avibe-bot%2Favibe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avibe-bot%2Favibe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avibe-bot","download_url":"https://codeload.github.com/avibe-bot/avibe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avibe-bot%2Favibe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34333806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agent-os","ai","ai-agents","chatops","claude","claude-code","codex","devtools","discord-bot","lark-bot","llm","local-first","opencode","slack-bot","vibe-coding","wechat"],"created_at":"2026-06-09T21:00:25.961Z","updated_at":"2026-06-14T19:00:57.016Z","avatar_url":"https://github.com/avibe-bot.png","language":"Python","funding_links":[],"categories":["AI for *Ops"],"sub_categories":["Automation \u0026 Self-Healing"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/logo.png\" alt=\"Avibe\" width=\"120\"/\u003e\n\n# Avibe\n\n### The local-first Agent OS — your AI partner lives on your own machine.\n\n**Own the agent. Reach it from anywhere. Never get locked in.**\n\n[![GitHub Stars](https://img.shields.io/github/stars/avibe-bot/avibe?color=ffcb47\u0026labelColor=black\u0026style=flat-square)](https://github.com/avibe-bot/avibe/stargazers)\n[![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?labelColor=black\u0026style=flat-square)](https://www.python.org/)\n[![License](https://img.shields.io/badge/license-MIT-green?labelColor=black\u0026style=flat-square)](LICENSE)\n\n\u003ca href=\"https://www.producthunt.com/products/vibe-remote?embed=true\u0026utm_source=badge-featured\u0026utm_medium=badge\u0026utm_campaign=badge-vibe-remote\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg alt=\"Avibe — the local-first Agent OS | Product Hunt\" width=\"250\" height=\"54\" src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1104967\u0026theme=light\u0026t=1774450119248\"\u003e\u003c/a\u003e\n\n[Docs](https://docs.avibe.bot) · [English](README.md) · [中文](README_ZH.md)\n\n**Drives** ![Claude Code](https://img.shields.io/badge/Claude%20Code-D4A27F?style=flat-square\u0026logo=anthropic\u0026logoColor=white) ![OpenCode](https://img.shields.io/badge/OpenCode-00B4D8?style=flat-square) ![Codex](https://img.shields.io/badge/Codex-412991?style=flat-square)\n\n**Reach it from** ![Browser](https://img.shields.io/badge/Browser-111827?style=flat-square\u0026logo=googlechrome\u0026logoColor=white) ![Slack](https://img.shields.io/badge/Slack-4A154B?style=flat-square\u0026logo=slack\u0026logoColor=white) ![Discord](https://img.shields.io/badge/Discord-5865F2?style=flat-square\u0026logo=discord\u0026logoColor=white) ![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=flat-square\u0026logo=telegram\u0026logoColor=white) ![WeChat](https://img.shields.io/badge/WeChat-07C160?style=flat-square\u0026logo=wechat\u0026logoColor=white) ![Lark](https://img.shields.io/badge/Lark%20%2F%20Feishu-3370FF?style=flat-square\u0026logo=bytedance\u0026logoColor=white)\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cimg src=\"assets/screenshots/v3/workbench-en.png\" alt=\"The Avibe Workbench — talk to your local agent from the browser\" /\u003e\n\n---\n\n## Your AI agent is brilliant — and stuck\n\nClaude Code, Codex, OpenCode are incredible. But:\n\n- 🖥️ **Trapped on one machine.** Your agent lives in a terminal. Close the laptop and it stops.\n- 📵 **Out of reach.** Away from your desk, you can't see what it's doing — let alone steer it.\n- 🔒 **Locked in.** Every tool wants to be the whole stack: its app, its cloud, its subscription, your code uploaded to someone else's box.\n\n## Avibe flips that\n\n**One command turns your own machine into the home your AI partner lives in.** You drive the *official* Claude Code, Codex, and OpenCode — from a browser or any chat app — while your code and keys stay on your machine, and avibe.bot never sees your data.\n\n```bash\ncurl -fsSL https://avibe.bot/install.sh | bash \u0026\u0026 vibe\n```\n\nThe browser opens, you follow a short wizard, and your machine becomes an Agent OS you can reach from anywhere.\n\n\u003e Open source — read the [install script](https://github.com/avibe-bot/avibe/blob/master/install.sh) first if you like. The short URL is a 307 redirect to that file.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOn Windows?\u003c/b\u003e\u003c/summary\u003e\n\nWe recommend WSL on Windows for the best compatibility — see [Run Avibe with WSL from scratch](docs/WINDOWS_WSL.md). It covers where to install WSL, which terminal to use, where to run the install command, and how to open the Web UI.\n\u003c/details\u003e\n\n\u003e 💚 **Built with Avibe.** This project was developed end-to-end using Avibe itself — steering Claude Code, Codex, and OpenCode from the browser and from my phone, picking up seamlessly whether I was at my desk or not. The deeper in I got, the faster it went. — [@alex_metacraft](https://x.com/alex_metacraft)\n\n---\n\n## What you get\n\n### 💬 A Workbench that goes where you do\n\nChat with your agent right in the browser — or install the Workbench as a desktop or mobile app and get a push notification the moment a job needs you. Same agent, same sessions, at your desk or on the move.\n\n### 🧠 Its own timeline — the Agent Harness\n\nMost AI tools only act when you type. Avibe gives your agent durable primitives — **run, schedule, watch, and inspect** — so it can start work, wait for the right moment, run in the background, and come back with results. Ask in plain language; it composes the commands.\n\n\u003cimg src=\"assets/screenshots/v3/harness-en.png\" alt=\"Agent Harness — scheduled tasks, watches, and run history\" /\u003e\n\n### 🧩 Skills across every agent\n\nReusable skills — your conventions, your workflows — managed in one place and shared across Claude Code, Codex, and OpenCode. Set them up once; every agent you run inherits them.\n\n\u003cimg src=\"assets/screenshots/v3/skills-en.png\" alt=\"Skills — manage agent skills across every backend, powered by askill\" /\u003e\n\n### 🎨 Show Pages — it shows, not just tells\n\nWhen a picture beats a paragraph, your agent hands you a live web page — a flowchart, a mind map, a dashboard, a diff — built for the task and reachable from your phone through the same tunnel.\n\n### 🎙️ Talk, don't type\n\nBuilt-in, high-quality voice-to-text. Brief your agent by voice — the fastest way to kick off work from your phone.\n\n### 📱 In your pocket\n\n\u003cimg src=\"assets/screenshots/v3/workbench-mobile-en.png\" alt=\"Avibe on mobile\" width=\"270\" align=\"right\" /\u003e\n\nYour machine runs the work; you don't have to sit in front of it. Run `vibe remote` and your local Workbench becomes reachable from any browser on Earth — through a secure `avibe.bot` tunnel — with no VPN, no port forwarding, and no public webhooks pointed at your laptop.\n\nYou're on a plane, at a café, on a borrowed laptop. The agent pings that a job needs you. Open the link, steer it, walk away again.\n\n- 🌍 **Your own `you-app.avibe.bot`** — 30-second sign-in, your slug for life\n- 🔒 **Fail-closed at every join** — auth, routing, and host checks default to \"deny\"\n- 📱 **Mobile-aware UI** — thumb-friendly, built for borrowed screens\n\n**Your data plane stays on your machine**; `avibe.bot` only carries the control-plane handshake.\n\n\u003cbr clear=\"all\"/\u003e\n\n**Plus** — per-channel agent routing · resumable sessions (thread = session) · instant agent switching · interactive prompts (buttons \u0026 modals) · file attachments · completion notifications.\n\n---\n\n## Why Avibe is different\n\n| | |\n|---|---|\n| **Local-first, and yours** | Your AI partner, its execution, your keys, and your data stay on your machine. `avibe.bot` only issues identity and a secure tunnel — it never proxies your data. |\n| **One substrate, every first-party agent** | Drive the *official* Claude Code, Codex, and OpenCode. Bring your own subscription or keys, switch per task, and never get locked into one vendor's silo. |\n| **Browser and chat, both first-class** | Operate from the browser Workbench, or from Slack, Discord, Telegram, WeChat, and Lark / Feishu. Same agent, same sessions. |\n| **No middleman** | No extra reasoning loop sits between you and your agent. Tokens go straight to the agent you chose. |\n\n---\n\n## How it works\n\n```\n┌──────────────┐            ┌──────────────┐            ┌──────────────┐\n│     You       │  browser   │              │   stdio    │  Claude Code  │\n│  (anywhere)   │   Slack    │    Avibe      │ ─────────▶ │  OpenCode     │\n│               │  Discord   │ (your machine)│ ◀───────── │  Codex        │\n│               │  Telegram  │              │            │               │\n│               │  WeChat    │              │            │               │\n│               │  Lark      │              │            │               │\n└──────────────┘            └──────────────┘            └──────────────┘\n```\n\n1. **You type** — in the browser or a chat app: *\"Add dark mode to the settings page.\"*\n2. **Avibe routes** to your configured agent, in the right project.\n3. **The agent** reads your local codebase, writes code, and streams back.\n4. **You review** in the same surface, iterate in the thread, and resume later from anywhere.\n\n**Your code stays on your machine.** Avibe runs locally and connects out via Slack Socket Mode, Discord Gateway, Telegram long-polling, WeChat polling, or Lark WebSocket — no public inbound ports for normal chat control. Prompts go only to the AI provider you choose.\n\n---\n\n## Avibe vs OpenClaw\n\n| | Avibe | OpenClaw |\n|---|---|---|\n| **Setup** | One command + web wizard. Done in minutes. | Gateway + channels + JSON config. Expect an afternoon. |\n| **Security** | Local-first. Socket Mode / WebSocket only. No public inbound ports, minimal attack surface. | Gateway exposes ports. More moving parts, more surface. |\n| **Token cost** | No extra reasoning loop in between. Tokens go straight to your chosen agent. | Every message carries a long persona/orchestration context. Tokens burn on overhead before your task starts. |\n| **Lock-in** | Drives the official agent CLIs; bring your own keys; switch per task. | Tied to its own assistant loop. |\n\nOpenClaw is an always-on personal assistant — great for casual chat, expensive for real work. Avibe is a **local-first Agent OS** for the agents you already trust: the agent stays itself, your data stays local, and the colleague experience comes from putting the agent into the flow where your work already happens.\n\n---\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDoes it run local models?\u003c/b\u003e\u003c/summary\u003e\n\nLocal-first here means your **code, data, and execution** stay on your machine — not the model weights. Avibe drives the agent you configure (Claude Code, Codex, OpenCode); OpenCode can point at local or OpenAI-compatible endpoints if you want inference local too.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhere do my code and data go?\u003c/b\u003e\u003c/summary\u003e\n\nYour code, keys, and agent processes stay on your own machine. `avibe.bot` only issues identity and a secure tunnel — it never proxies or stores your data. Prompts go only to the AI provider you chose.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDo I have to pay for Avibe?\u003c/b\u003e\u003c/summary\u003e\n\nAvibe is open source (MIT) and free to run. You bring your own agent subscription or API keys and pay your provider directly — no markup, no second subscription.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWhich agents and platforms are supported?\u003c/b\u003e\u003c/summary\u003e\n\n**Agents:** the official Claude Code, Codex, and OpenCode CLIs. **Surfaces:** a built-in browser Workbench plus Slack, Discord, Telegram, WeChat, and Lark / Feishu.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eIs remote access secure?\u003c/b\u003e\u003c/summary\u003e\n\n`vibe remote` opens a Cloudflare tunnel; browser traffic reaches your machine only after sign-in. Auth, routing, and host checks are **fail-closed**, and there are no public inbound ports for normal chat control.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow is Avibe different from OpenClaw or Hermes?\u003c/b\u003e\u003c/summary\u003e\n\nOpenClaw and Hermes are *agents* — a gateway-style assistant and a self-improving agent. Avibe is a different layer: the **Agent OS**. It gives any agent a unified world model — agents, sessions, Show Pages, the Harness — so it can schedule itself, build its own loops, and reach you through a real interaction layer, then runs the official Claude Code, Codex, and OpenCode you bring (an Avibe-native agent is [on the roadmap](#roadmap)). See the [comparison table](#avibe-vs-openclaw) above for OpenClaw specifics.\n\u003c/details\u003e\n\n---\n\n## Talk to it like a colleague\n\nAsk in plain language and the Harness composes the commands behind the scenes:\n\n- *\"Watch this PR and come back when there's actionable review feedback.\"*\n- *\"Run the deployment check every weekday morning and post the summary here.\"*\n- *\"Start a separate investigation session for this incident, but report the conclusion to this channel.\"*\n- *\"If CI fails, summarize the logs; if it passes, tell me whether the PR is mergeable.\"*\n\n**Switch agents mid-conversation** — just prefix your message:\n\n```\nPlan: design a new caching layer for the API\n```\n\n**Route per project** — different work, different agent:\n\n```\nfrontend   → OpenCode    (fast iteration)\nbackend    → Claude Code  (complex logic)\nprototypes → Codex        (quick experiments)\n```\n\n---\n\n## Meet Vibey\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"assets/mascot/cloud-tuanzi.png\" alt=\"Vibey — the gaseous consciousness inside Avibe\" width=\"200\"/\u003e\n\u003c/div\u003e\n\nLives in your Workbench and your chat apps. Reads the room. Picks up where you left off. Asks the right question when it's unsure. 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.\n\n\u003e Avibe is the home your agent lives in. Vibey is the colleague who lives there.\n\nForgets nothing. Holds opinions. Says thanks when you fix its bugs.\n\n---\n\n## Commands\n\n```bash\nvibe            # Start Avibe and open the Workbench\nvibe status     # Check service and configuration status\nvibe stop       # Stop the local service\nvibe doctor     # Diagnose common setup issues\nvibe remote     # Reach your Workbench from any device via avibe.bot\nvibe agent      # Run and manage Avibe agents\nvibe task       # Schedule time-based work (cron / one-off)\nvibe watch      # Wait on a condition, then act\nvibe runs       # Inspect agent run history\n```\n\n| In chat | What it does |\n|---|---|\n| Mention the bot | Start a task or ask a question |\n| Reply in thread | Continue the same agent session |\n| `/stop` | Stop the current session |\n\nFull references: [Commands](docs/COMMANDS.md) · [CLI](docs/CLI.md)\n\n---\n\n## Prerequisites\n\nYou need at least one agent installed:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOpenCode\u003c/b\u003e (recommended)\u003c/summary\u003e\n\n```bash\ncurl -fsSL https://opencode.ai/install | bash\n```\n\nAdd to `~/.config/opencode/opencode.json` to skip permission prompts:\n\n```json\n{ \"permission\": \"allow\" }\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nnpm install -g @anthropic-ai/claude-code\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCodex\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nnpm install -g @openai/codex\n```\n\u003c/details\u003e\n\n---\n\n## Security\n\n- **Local-first** — Avibe runs on your machine; your code and agent processes stay there.\n- **No public inbound ports** — Socket Mode / WebSocket / long-polling only for chat control.\n- **Your keys, your data** — stored under `~/.avibe/`, sent only to the AI provider you chose. Existing installs keep `~/.vibe_remote/` as a compatibility path.\n- **Fail-closed remote access** — `avibe.bot` only brokers identity and the tunnel, never your data.\n\n---\n\n## Uninstall\n\n```bash\nvibe stop\nuv tool uninstall avibe-os\nuv tool uninstall vibe-remote   # legacy installs\nrm -rf ~/.avibe ~/.vibe_remote\n```\n\n---\n\n## Roadmap\n\nWhat's coming next:\n\n- **Vault** — hand secret keys straight to an encrypted backend, never through the agent. When a job needs one, a CLI writes it to a file at runtime, so it never enters the agent's context.\n- **Interaction-first interface** — less wall-of-text chat, more doing: annotate and act directly on interactive pages, and talk to your agent right there.\n- **SaaS mode** — one-click hosted onboarding with a cloud relay, while execution still stays on your own machine.\n- **An Avibe-native agent** — a first-party agent tuned for this runtime, alongside the official CLIs you bring.\n\nShipped recently: the Agent Harness, Show Pages, voice-to-text, and the Skills manager.\n\n---\n\n## Docs\n\n- **[Official Docs](https://docs.avibe.bot)** — quickstart, concepts, platform \u0026 agent guides, troubleshooting\n- **[What is Avibe](https://docs.avibe.bot/concepts/agent-os)** — the Agent OS model\n- **[CLI Reference](docs/CLI.md)** · **[Commands](docs/COMMANDS.md)**\n- **[Install via AI agent](docs/INSTALL_FOR_AI.md)** — hand this to Claude Code, Codex, or OpenCode for guided setup\n- **[Slack](docs/SLACK_SETUP.md)** · **[Discord](docs/DISCORD_SETUP.md)** · **[Telegram](docs/TELEGRAM_SETUP.md)** setup guides\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Own the agent. Reach it from anywhere.**\n\n[Install Now](#avibe-flips-that) · [Docs](https://docs.avibe.bot) · [Report a bug](https://github.com/avibe-bot/avibe/issues) · [Follow @alex_metacraft](https://x.com/alex_metacraft)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favibe-bot%2Favibe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favibe-bot%2Favibe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favibe-bot%2Favibe/lists"}