Skip to content
This repository was archived by the owner on Mar 20, 2026. It is now read-only.

peacock0803sz/vibra

Repository files navigation

Vibra

AI agent interaction platform for solo developers. Operate multiple AI agents (Claude Code, Codex CLI, Gemini CLI) from any device over your personal Tailscale network.

Features

  • Streaming Chat - Real-time response streaming with ConnectRPC (server-sent events)
  • Multi-Agent Support - Pluggable adapter architecture for Claude, Codex, Gemini
  • Container Isolation - Each agent runs in a Docker container with configurable permission profiles (OBSERVE / VERIFY / EDIT / FULL)
  • Tailscale Auth - Zero-config authentication via Tailscale identity headers
  • Session Persistence - Resume conversations across devices
  • Mobile Responsive - Touch-optimized UI for on-the-go use

Getting Started

Install

Binary (Linux / macOS):

# Download from GitHub Releases (replace OS and ARCH)
curl -Lo vibra.tar.gz https://github.com/peacock0803sz/vibra/releases/latest/download/vibra_linux_amd64.tar.gz
tar xzf vibra.tar.gz && sudo mv vibra /usr/local/bin/

NixOS / nix-darwin (recommended):

{
  inputs.vibra.url = "github:peacock0803sz/vibra";
  # NixOS: vibra.nixosModules.vibra
  # Darwin: vibra.darwinModules.vibra
}

Run

export VIBRA_ALLOWED_DIRS="$HOME/projects"
export ANTHROPIC_API_KEY="sk-ant-..."
vibra

See docs/setup.md for installation, configuration, and service management.

Architecture

proto/vibra/           # Protobuf definitions (single source of truth)
back/                  # Go + connect-go server
  cmd/vibra/           # Main binary
  internal/            # adapter/, server/, auth/, container/, sandbox/
  gen/                 # buf-generated Go code
front/                 # React Router v7 + connect-es client
  app/                 # routes/, components/, lib/
  gen/                 # buf-generated TypeScript code
images/                # Agent container Dockerfiles (claude, codex, gemini)

Tech Stack

Layer Technologies
Backend Go 1.25+, connect-go
Frontend React Router v7, TypeScript, connect-es, TailwindCSS
Protocol Protocol Buffers v3, Buf CLI
Container Docker / Podman
Linting oxlint, oxfmt (Rust-based)
Dev Environment Nix flake + direnv

Development

See CONTRIBUTING.md for dev setup, code style, and testing instructions.

About

Experimental; AI agent interaction platform for solo developers

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors