Install
$ agentstack add mcp-jjjjjjjjnnjnn-relayos ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ● Network access Used
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Git for AI Conversations. Fork, merge, and weave AI conversations together.
Your browser does not support the video tag. Download video
pip install relayos && relay
👋 The Problem
You switch between ChatGPT, Claude, Gemini, and DeepSeek. You copy output from one, paste into the next. You lose context between sessions. You spend 30% of your time managing tools instead of building.
And when you have a conversation that matters — a system design, an architecture review — it's trapped in a single session. You can't branch it, merge it, or build on it later.
🎯 The Solution
RelayOS treats AI conversations like code. Fork, merge, and weave them together.
#12 数据库设计 #25 API设计
│ │
├── /fork → #18 数据库v2 │
│ │
└────────── /merge ──────────────────┘
│
▼
#31 系统架构
(Derived: #12 #25)
Zero config. Auto-detects your installed AI CLIs.
pip install relayos && relay
✨ What Makes RelayOS Different
| Feature | What It Does | |---------|-------------| | 🔀 Conversation Graph | /fork /merge /attach — Git for conversations | | 🧠 Auto Routing | CLI-first, zero-config, auto-detects installed tools | | 💰 Budget Guard | Per-task/daily/monthly hard limits, no surprise bills | | 🔌 Unified Provider | API + CLI — zero-config, Tab to cycle providers | | ⌨️ OpenCode-Style TUI | Ctrl+P command palette, Tab/Shift+Tab, Switch Session panel | | 💾 Cross-Session Memory | /remember facts that persist across conversations | | 🌐 i18n | Chinese + English auto-detect | | 🚀 3 Modes | Auto (no ask) / Edit (confirm) / Group (multi-provider) |
⚡ Quick Start
pip install relayos
relay
Opens the workspace. Type a task, press Enter.
No config required. RelayOS auto-detects your installed AI CLIs (claude, opencode, mimo, etc.) If none found, the setup wizard guides you.
One-liner tasks
relay "设计一个支付系统" # Auto-routes to best workers
relay "Review this code" # Detects intent automatically
relay "Explain Kubernetes" # Single chat
Conversation branching
/fork Branch current conversation
/merge id1 id2 Merge conversations together
/attach id Import another session's context
/remember k: val Save knowledge across sessions
Cost control
relayos cost report
# Today: $0.023 / $1.00
# This month: $0.187 / $10.00
Session management
/help Show all commands
/new New conversation
/clear Clear messages
Ctrl+P Command palette
Tab Cycle provider
Shift+Tab Cycle mode
🖥️ The TUI
┌─ RelayOS sess-31 [Mimo] [AUTO] $0.02 ─┐
│ │
│ > 设计一个支付系统 │
│ │
│ [Mimo] 建议使用事件溯源架构,原因如下: │
│ 1. 幂等性天然保证 │
│ 2. 审计日志免费获得 │
│ │
├──────────────────────────────────────────────┤
│ > 帮我修一下审查问题█ │
│ Ctrl+P=palette Tab=provider /fork /merge │
└──────────────────────────────────────────────┘
| Shortcut | What | |----------|------| | Ctrl+P | Command palette (all settings) | | Tab | Cycle through installed CLI providers | | Shift+Tab | Cycle mode: auto → edit → group | | Enter | Send message / Confirm | | ↑/↓ | Input / history navigation | | Esc | Cancel / clear input | | Backspace | Delete character | | Ctrl+U | Clear input line | | Ctrl+C | Exit
Command palette (Ctrl+P)
Command Palette (Esc close)
────────────────────────────────────────────────
Session:
New Session Start fresh conversation
Fork Session Branch from current session
Merge Sessions Combine multiple sessions
Switch Session Browse all sessions
Attach Session Import context from another session
Knowledge:
Remember Fact Save knowledge: /remember key: value
Browse Knowledge Explore stored facts
Settings:
Toggle Mode Auto / Edit / Group
Budget Spending limits
System:
Quit Exit RelayOS
Filter: (type to filter)
Up/Down | Enter | Esc
Switch Session Panel (Ctrl+P → Switch Session)
Sessions (Esc to close)
────────────────────────────────────────────────
> Search: | ← Tab to switch
conv-payment [Mimo] 2m
设计一个支付系统...
conv-review [Claude] 30m
Review PR for security...
Tab=switch ↑↓=navigate Enter=open d=delete Esc=close
Conversation Graph View
Conversation Graph
────────────────────────────────────────────────
└── Payment Design
└── Architecture v1
├── Architecture v2
└── > Final Arch
▲
│
└── Cache Layer ────────────────────┘
🗺️ Architecture
Terminal (relay / relayos)
│
▼
┌──────────────────────────────────────────────┐
│ Conversation Graph │
│ (fork / merge / attach / session lifecycle) │
└──────────────────┬───────────────────────────┘
│
┌──────────────────▼───────────────────────────┐
│ ProviderRouter │
│ (weighted routing, auto/edit mode, budget) │
└──────┬──────────────────────┬────────────────┘
│ │
┌──────▼──────┐ ┌─────────▼──────────┐
│ API Prov. │ │ CLI Provider │
│ OpenAI │ │ claude / opencode │
│ Anthropic │ │ mimo / codex │
│ Google │ │ (auto-detected) │
│ DeepSeek │ └────────────────────┘
└─────────────┘
Storage (all SQLite, zero infrastructure)
~/.relayos/
├── config.yaml ← Your provider config
├── sessions.db ← Sessions + conversation graph
├── knowledge.db ← Cross-session memory
├── cost.db ← Usage + spending
├── state.db ← Project facts + decisions
├── artifacts.db ← Structured outputs
├── workers.db ← Worker definitions
└── inbox.db ← Messages
Design Philosophy
| Principle | Why | |-----------|-----| | Conversation Graph | Fork/merge conversations like code. Git for AI. | | Zero config | Auto-detect installed AI CLIs. No API keys required. | | Budget-first | Hard spending limits. No surprise bills. | | Auto by default | Workers auto-assigned. Provider names hidden. | | i18n native | Chinese + English. Auto-detect system language. |
📈 Version History
| Version | What | |---------|------| | V0.1 | Model routing — 5 provider adapters | | V0.2 | Terminal pool — multi-CLI, cost tracking | | V0.3 | Worker system — 8 roles, persistence, TUI | | V0.4 | State compiler — structured state, event sourcing | | V0.5 | Model scheduler — 15 models, 3 cost profiles | | V0.6 | Session system — chat/ask/group modes | | V0.7 | Capability graph — multi-step decomposition | | V0.8 | Task graph execution — schema-aware artifact passing | | V0.9 | Cross-session memory — project knowledge | | V0.10 | Unified Provider — API + CLI abstraction | | V0.11 | Conversation Graph — fork/merge/attach | | V0.12 | OpenCode-style TUI + Graph View + BudgetGuard |
💪 Built With
| Component | Tech | |-----------|------| | Language | Python 3.10+ | | CLI + TUI | Click + Rich | | HTTP Client | HTTPX | | Storage | SQLite (zero infra) | | License | Apache 2.0 |
Credits
- Claude Code (Anthropic) — Primary development platform
- OpenCode — TUI design inspiration
- ECC plugin system — Agent orchestration patterns
📦 Installation
pip install relayos
From source
git clone https://github.com/jjjjjjjjnnjnn/relayos.git
cd relayos
pip install -e .
Optional: web dashboard
pip install relayos[server]
relayos serve --open
🌐 Languages
- [English](README.md)
- [中文 (Chinese)](README_ZH.md)
- [Deutsch (German)](README_DE.md)
- [Français (French)](README_FR.md)
- [Español (Spanish)](README_ES.md)
- [日本語 (Japanese)](README_JP.md)
- [한국어 (Korean)](README_KR.md)
📄 License
[Apache 2.0](LICENSE) Copyright 2026 jjjjjjjjnnjnn
Stop copy-pasting between AI tools. Fork, merge, and weave conversations together.
pip install relayos && relay
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: jjjjjjjjnnjnn
- Source: jjjjjjjjnnjnn/relayos
- License: Apache-2.0
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.