Alimenter votre agent
La commande propre à l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un terminal.
claude mcp add cybara -- npx -y cybara@1.0.2577À exécuter dans un terminal.
{ "mcpServers": { "cybara": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerDe l'éditeur
Prefer the desktop GUI? Download Cybara for macOS, Windows, or Linux from cybara.ai/download, or get every installer directly from GitHub Releases.
Install the latest Cybara CLI on macOS or Linux:
curl -fsSL https://cybara.ai/install.sh | bash
Self-hosted, open-source AI agent platform — CLI
On Windows PowerShell:
powershell -c "irm https://cybara.ai/install.ps1 | iex"
Then launch Cybara:
cybara
The installer selects the correct release for the current platform and verifies its published SHA256 checksum. You can also run Cybara without installing it with bunx cybara.
Cybara is one operator-controlled runtime for:
If you need an agent platform that can plan, execute, verify, and report with strong operator control, Cybara is built for that.
Source development uses Bun only for dependency installation, tasks, and tests.
# Clone
git clone https://github.com/metaspartan/cybara.git
cd cybara
# Install dependencies
bun install
# Start full dev stack (backend + built UI + watch)
bun run dev
Then open:
http://localhost:4269http://localhost:4269/api/healthUpdate an installed CLI with:
cybara update # verify SHA256, then download + install
cybara update --check # just report whether a newer release exists (non-zero if stale)
cybara update --force # reinstall even when already current
The Tauri desktop app checks the same GitHub release channel from Settings -> Desktop Updates and can install signed app updates in place. The native SwiftUI macOS app provides its own checksum-verified updater from App -> Check for Updates....
Production deployment guidance: docs/production.md
Cybara ships two desktop shells over the same Bun sidecar/runtime contract:
apps/macos/Cybara, packaged as a .app bundle with the compiled sidecar, web UI, secp256k1.wasm, and local indexing runtime assetsbun run tauri:dev # Tauri desktop dev mode
bun run tauri:build # Tauri production build
bun run tauri:build:release # Tauri build with updater config/signatures
bun run native:macos:run # Build UI + sidecar, then run the SwiftUI shell
bun run native:macos:package # Build native SwiftUI .app + zip
Cybara Mobile is a system-aware Liquid Glass-inspired React Native app for iOS and Android, with light and dark appearance overrides. It connects to a Cybara gateway already running from CLI, Tauri/Web UI, native macOS, or a hosted deployment, then manages remote sessions and operator settings.
bun run mobile:dev
bun run mobile:ios
bun run mobile:android
bun run mobile:expo-check
# on the device running Cybara
cybara mobile connect --url http://192.168.1.20:4269 --device "Carsen iPhone"
The CLI and Web UI/Tauri Mobile page create QR pairings with revocable per-device tokens, so a phone can be revoked without rotating the root gateway API key. Pairing can use LAN access or a configured remote access URL from Settings → Gateway, including private mesh networks such as Tailscale/ZeroTier/NetBird or password-protected HTTPS tunnels. The mobile surface covers gateway health, sessions, agents, providers, provider plan limits, metrics, speech settings, tool approvals, wallet policy, channels, tasks, memory, terminal/log entrypoints, gateway controls, and settings summaries. See apps/mobile/README.md.
Release CI exports Expo bundles for iOS and Android and can also build signed Android AAB/APK and iOS IPA/TestFlight artifacts when the relevant store signing secrets are configured.
Build and run a production container:
docker build -t cybara:latest .
docker run --rm -p 4269:4269 \
-e CYBARA_API_KEY=cybara_dev_key \
-v ~/.cybara:/root/.cybara \
cybara:latest
Then open http://localhost:4269.
main, research, coder, planner, ops, subagent, worker)Tool categories currently shipped:
file: read/write/edit/search/grep/workspace_index/apply_patch — with a hard path-safety deny-list (credentials, SSH keys, .env) enforced before every writeprocess: exec/process/gitbrowser: browser/web_fetch/web_search/canvasmemory: search/get/save/context/durable savecore: sessions/agents/artifacts/wallet/http/env/data/nodes/clipboard/cron/gateway/etc.lsp: diagnostics/definition/references/hover/languagesmedia: image/tts + image_generate / video_generate / music_generate via a swappable provider registry (OpenAI, fal.ai, and MuAPI with FAL_KEY/FAL_API_KEY or MUAPI_API_KEY)skill: calc/convert/pdf/ocr/summarization/video_frames/weather/mactop + skill_save (agents codify a successful procedure as a reusable skill for future sessions)channel: message/telegram_mediaplanning: todo (session task-list with status discipline) + clarify (structured multi-choice questions to the user)discovery: tool_search / tool_describe / tool_call (dynamic discovery over built-in + MCP + skills) + execute_code (run code that calls cybara tools programmatically)media: computer_use (bundled background desktop control for capture/click/type/scroll/drag without stealing the cursor)orchestration: the kanban multi-agent tier — show/list/complete/block/heartbeat/comment/create/unblock/link for durable task graphs — plus mixture_of_agents (fan out to N proposer agents, synthesize one answer)See full reference: docs/tools.md
exec/git tool callssandbox-execpodmandockerallow or deny) for sandboxed executionCommand Sandbox) or config key sandbox_runtimeAvailable adapters include:
whatsapp-web.js), Signal (signal-cli), iMessage (BlueBubbles)Inbound webhook adapters verify signatures with constant-time comparison (crypto.timingSafeEqual).
DM policy modes:
pairingallowlistopendisabledfull / standard / readonlychat, manage, read, wallet, terminal — so a phone can be granted chat access without wallet or terminalapps/macos/Cybara that reuses the same local Cybara sidecar contract and can be packaged into a signed/notarized .app bundleCybara supports popular providers including OpenAI, Anthropic, Google Gemini, xAI Grok, Z.AI, MiniMax, Kimi, Qwen, DeepSeek, and OpenRouter, plus local runtimes such as Ollama and vLLM. Model lists are discovered dynamically when supported.
Provider plan monitoring tracks local usage against manual limits or provider-specific coding-plan presets. The router can enforce rolling 5-hour, rolling-week, and monthly windows for flat coding plans, while pay-as-you-go routes can use token pricing and monthly budgets for spend-aware routing.
Named provider account pools group multiple configured accounts for usage-balanced routing or an explicit priority override. Agents and model-router routes can target a pool directly, while per-account environment key rotation (ANTHROPIC_API_KEY, _2, _3, …) remains available for API-key failover. Anthropic prompt caching is applied automatically to stable prompt content and recent turns, with provider-reported cache reads and writes included in usage metrics.
See provider details: docs/providers.md
Cybara both consumes external MCP servers (extending agent capabilities) and exposes itself as an MCP server so other clients can call cybara's tools:
cybara mcp serve to expose built-in tools to MCP clients over stdio JSON-RPCMCP server management and registry integration:
UI: manage MCP services in Settings → MCP Servers and bundled extensions in Settings → Plugins.
CLI: cybara mcp list, cybara mcp search <query>, cybara mcp install <package>, cybara mcp popular, cybara mcp serve
Settings → Plugins brings installed skill bundles, a searchable built-in catalog, MCP services, and account apps into one extension surface. Installed plugins can be enabled or disabled without restarting the gateway. Google Workspace, Microsoft 365, Dropbox, and Notion account apps default to read-only access; optional writes remain subject to Cybara's normal tool approval policy. Credentials and OAuth tokens use the encrypted secret store.
Plugins can be discovered from bundled, local, and workspace directories. Additional services can be connected through HTTPS or trusted local MCP servers.
CLI: cybara plugin list, cybara plugin discover [query], cybara plugin enable <id>, cybara plugin disable <id>, cybara plugin install <folder-or-zip>, cybara plugin apps, cybara plugin configure <app-id> --client-id <id>, cybara plugin connect <app-id>
bun run dev # Full dev flow
bun run build # Build backend
bun run build:all # Build UI + backend + CLI + main
bun run start # Run built backend
bun run start:prod # Build all then run
bun run package # Build local release/cybara + release UI assets
bun test # Full test suite
bun run test:smoke # Runtime + API + E2E smoke
bun run test:smoke:full # Broader live E2E smoke suite
RUN_BROWSER_E2E=1 bun test tests/e2e/ide-web-ui-browser-smoke.test.ts # Real browser IDE smoke
bun run check # Typecheck + lint + format check
bun run check:loc # Enforce max TS/TSX file size
bun run check:ci # CI gate (typecheck + lint + loc + Expo mobile check + smoke + deadcode report)
bun run tauri:dev # Desktop dev mode
bun run tauri:sidecar # Build the platform sidecar and bundled sidecar runtime assets
bun run tauri:build # Desktop production build
bun run tauri:prepare-release # Generate signed updater config from env
bun run tauri:build:release # Build desktop app with updater artifacts
bun run native:macos:build # Build the SwiftUI macOS app shell from source
bun run native:macos:run # Build UI + sidecar, then run the SwiftUI shell
bun run native:macos:package # Package the native SwiftUI macOS app bundle
bun run mobile:typecheck # Type-check React Native companion
bun run test:mobile # Mobile helper tests
Cybara exposes a broad REST API and streaming interfaces.
Common surfaces:
/api/chat, /api/sessions (legacy /api/chat/sessions remains supported)/api/router/*, /api/provider-plans/*/api/wallet/*/api/migrations/*, /api/speech/*/api/auth/*, /api/system/restart/api/sse/status/api/ws/statusFull reference: docs/api.md
cybara chat
cybara chat --agent agent-codex --workspace ~/Documents/GitHub/cybara
cybara chat steer <session-id> <pending-id>
cybara tui chat
cybara tui usage
cybara tui providers
cybara tui router
cybara tui channels
cybara tui memory
cybara tui tools
cybara status
cybara gateway logs --tail 100
cybara models <provider-id>
cybara doctor
cybara security scan .
cybara provider available
cybara completion zsh
cybara channels
cybara wallet status
cybara wallet swap --venue uniswap_v3 --token LINK --amount-eth 0.2
cybara wallet x402 --url https://merchant.example/x402/resource --dry-run
cybara subagent spawn "Research X and return a summary"
cybara subagent wait <run-id> --timeout 120
cybara mcp list
cybara mcp search <query>
cybara mcp install <package>
cybara migrate sources
cybara migrate --from <source> --apply --preset user-data
The terminal chat supports the same session-oriented workflow as the app clients: searchable history, queued follow-ups while a run is active, steering, pending-message edit/delete/reorder, agent switching, workspace switching, markdown emphasis, grouped tool/activity output, numbered response copying, and portable conversation export.
Full CLI reference: docs/cli.md
Cybara builds each model request from the effective runtime state rather than one static prompt:
SKILL.md loadingTool policy and sandbox enforcement remain authoritative even if prompt text or untrusted content claims otherwise. See Agent Runtime and Prompt Architecture for the implemented contract.
src/
api/ # REST routes, chat, terminal, IDE/git API, security
core/ # agents, tools, wallet, channels, providers, memory, LSP, scheduler
cli/
index.tsx # CLI/TUI entry
commands/ # nonvisual command handlers
tui/ # terminal state and formatting
components/ # Ink views
index.ts # server entry
ui/
src/pages/ # UI pages
src-tauri/ # Tauri desktop shell
apps/mobile/ # React Native iOS/Android companion
apps/macos/Cybara/ # Native SwiftUI macOS shell
docs/ # product and technical docs
tests/ # Bun test suites (unit/integration/e2e)
.github/workflows/ # CI, release, security, and platform build workflows
$CYB is Cybara's community meme token on Solana.
J2hyZSVokSTuy3bG85A5xfs3umCeGtqZZEdKtGTTpumpTrading fees support the continued development of the Cybara project.
Meme tokens are highly volatile and speculative. Verify the contract address, trade responsibly, and never risk more than you can afford to lose. $CYB does not represent equity, ownership, or a claim on Cybara software or revenue.
Create contribution branches from dev and open pull requests against dev.
The main branch is reserved for releases. See
CONTRIBUTING.md for setup, validation, and review requirements.
MIT — Carsen Klock
{ "mcpServers": { "cybara": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Cybara s'exécute en local via stdio.
Dernière vérification : 2026-11-10. Self-hosted, open-source AI agent platform — CLI