claudeers.
// Other

agent-relay-portable

Local conversation migration and portable conversation/Skill storage for WorkBuddy, DSH, CodeBuddy, Claude Code/SDK and Codex. Windows, macOS and Linux.

// Other[ cli ][ web ][ claude ]#claude#other◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit about 1 month ago
last release about 1 month ago
releases 8
open issues 1
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up agent-relay-portable (git-clone project) into my current project.
Found on https://claudeers.com/agent-relay-portable
Repo: https://github.com/FriedOnion2/agent-relay-portable
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/FriedOnion2/agent-relay-portable
Category: other. Platforms: cli, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/FriedOnion2/agent-relay-portable

// compatibility

Platformscli, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

AgentRelay Portable

中文 | English

在本机浏览、导出和迁移 AI 编程助手的对话与 Skill,并可打包到移动盘,在另一台设备恢复。

支持 WorkBuddy、DeepSeek Harness(DSH)、CodeBuddy、Claude Code、Claude Agent SDK、OpenAI Codex、腾讯元宝 JSON 导出,提供中英文网页和命令行,适用于 Windows、macOS、Ubuntu / Linux。

AgentRelay 任务首页:迁移会话、跨设备搬运、全文搜索与 Skill 资产

🔒 数据只在本机处理。 服务只监听本机地址,不上传会话,不调用模型;迁移前先预览“保留 / 降级 / 丢弃 / 未知”,确认后才写入。

能做什么

  • 查看与导出:按来源浏览、搜索、预览会话,导出为 Markdown。
  • 跨软件迁移:把会话转换到 WorkBuddy、DSH、Claude Code、Codex,保留可表达的正文、思考和工具历史。
  • 跨设备存储:把对话、Skill 保存为原生 ZIP 包,复制到另一台设备后恢复到对应软件。
  • 全文搜索:本地 SQLite/FTS5 索引,支持中文短词、中英混合与来源 / 项目 / 时间 / 工具筛选。
  • 提炼 Skill 草稿:从多条相似的历史会话提炼带证据的 Skill 草稿,由你审核后导出,不自动安装或执行。
  • Windows ↔ Ubuntu:双系统间搬迁同款软件的原生记录。

快速开始

正式版:v1.0.0。各 Agent 的实测范围见下方支持表与 兼容状态。

当前开发版本:1.1.0-dev(计划 1.1 版,尚未正式发布)。

普通用户:到 Releases 下载 AgentRelay-<版本>-universal.zip,完整解压后运行启动器。总包内置 Python 与依赖,无需另装 Python / Node.js,首次启动不联网下载。不要选择 GitHub 自动生成的 Source code 压缩包。

设备启动入口支持范围
Windows启动_AgentRelay.batWindows 10/11 x64
macOSAgentRelay.app 或 bash 启动_AgentRelay.commandApple Silicon:macOS 14+;Intel:macOS 15+
Linuxbash 启动_AgentRelay.shUbuntu 22.04+ / glibc 2.35+ x64

启动后在浏览器打开提示的地址(默认 http://127.0.0.1:8745/)。退出请点网页右上角「退出服务」。macOS 应用未经 Apple 公证,被系统阻止时的处理见 安装与启动。

从源码运行(需要 Python 3.8+):

python -m pip install -r requirements-optional.txt   # 读写 DSH 压缩历史需要 zstandard
python app/cli.py serve                              # 启动网页
python app/cli.py list codex                         # 命令行:列出某来源的会话
python app/cli.py export codex <会话id> -o out.md    # 导出 Markdown
python app/cli.py transfer codex <会话id> --to dsh --dry-run   # 先预览迁移
python app/cli.py --lang en list codex                # 命令行输出改为英文(或设 RELAY_LANG=en)

用 pip / pipx 安装(只用命令行和网页,不需要 U 盘便携):

pipx install git+https://github.com/FriedOnion2/agent-relay-portable   # 或 pip install .
relay serve
relay list codex

这种方式下配置、日志和存储包放在每用户数据目录(Linux ~/.local/share/agent-relay,macOS ~/Library/Application Support/AgentRelay,Windows %APPDATA%\AgentRelay),可用 RELAY_PORTABLE_ROOT 指定别处。

Ubuntu / macOS 可用 Ubuntu首次准备.sh / Mac首次准备.command 自动建立隔离环境。完整步骤见 安装与启动。

支持的来源

来源默认会话位置读取 / 导出作为迁移目标实机验证
WorkBuddy~/.workbuddy/projects✅✅仅文件层核对
DeepSeek Harness / DSH~/.dsh/sessions✅(v0–v4)✅真实客户端已验证
CodeBuddy CLI / IDE~/.codebuddy/projects 等✅—仅文件层核对
Claude Code~/.claude/projects✅✅导出已验证
Claude Agent SDK~/.claude/projects(与 Claude Code 共享)✅—与 Claude Code 共享存储
OpenAI Codex~/.codex/sessions✅✅真实客户端已验证
腾讯元宝 JSON 导出便携目录 imports/yuanbao✅仅导出文件存包恢复合成 JSON 回归,未验证原生客户端

元宝入口位于「迁移会话 → 腾讯元宝」:填入兼容 JSON 文件的本机绝对路径后导入。需要先取得 JSON 导出;本次不读取元宝电脑版数据库或云端账户,也不把 ZIP 写回元宝客户端。换设备后可恢复到 AgentRelay 再查看或迁出,见元宝使用与格式说明。

“实机验证”指用真实客户端打开、续聊过迁移或恢复后的会话;其余只验证了文件层读写。厂商格式可能变化,详见 兼容状态 与 当前限制。

文档

完整索引见 docs/README.md,分为使用指南(guide/)、参考(reference/)、开发与维护(dev/)和调研记录(research/)。常用入口:

主题文档
下载、安装、启动与退出docs/guide/install.md
网页任务导航、恢复与草稿打包docs/guide/web-workflow.md
批量存储、跨软件 / 双系统迁移与预览docs/guide/storage-and-migration.md
搜索与 Skill 草稿docs/guide/search-and-skills.md
便携存储、Ubuntu 双系统docs/guide/portable-storage.md · docs/guide/ubuntu-dual-boot.md
配置与数据目录、故障排查docs/guide/configuration.md · docs/guide/troubleshooting.md
兼容状态、已知限制、来源格式docs/reference/compatibility.md · docs/reference/limitations.md · docs/reference/source-formats.md
腾讯元宝接入范围docs/reference/yuanbao-compatibility.md
适配器与插件开发、测试docs/dev/adapters.md · docs/dev/writing-a-plugin.md · docs/dev/testing.md
命令行完整说明命令行参考(快速上手见 使用说明.md)

参与贡献

欢迎提 issue 和 PR:请先阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 私密报告。版本变更见 CHANGELOG.md,维护流程见 docs/dev/maintainers.md。

许可

MIT License

// faq

What is agent-relay-portable?

Local conversation migration and portable conversation/Skill storage for WorkBuddy, DSH, CodeBuddy, Claude Code/SDK and Codex. Windows, macOS and Linux.. It is open-source on GitHub.

Is agent-relay-portable free to use?

agent-relay-portable is open-source under the MIT license, so it is free to use.

What category does agent-relay-portable belong to?

agent-relay-portable is listed under other in the Claudeers registry of Claude-compatible tools.

69 views
★ 17 stars
unclaimed
updated about 1 month ago

// embed badge

agent-relay-portable on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agent-relay-portable.svg)](https://claudeers.com/agent-relay-portable)

// retro hit counter

agent-relay-portable hit counter
[![Hits](https://claudeers.com/api/counter/agent-relay-portable.svg)](https://claudeers.com/agent-relay-portable)

// reviews

// guestbook

0/500

// related in Other

🔓

符合nature论文学术表达和科研绘图的Skill

// otherYuan1z0825/⟨Python⟩★ 54,085◷ Apache-2.0[ claude ]
🔓

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

// otherNutlope/⟨CSS⟩★ 49,642◷ MIT[ claude ]
🔓

Huashu Design · HTML-native design skill for Claude Code · Claude Code 里 HTML 原生的设计 skill · 高保真原型 / 幻灯片 / 动画 + 20 设计哲学 + 5 维评审 + MP4 导出 · Agent-agnostic

// otheralchaincyf/⟨HTML⟩★ 28,944◷ MIT[ claude ]
🔓

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

// othermanaflow-ai/⟨Swift⟩★ 28,842◷ NOASSERTION[ claude ]
→ see how agent-relay-portable connects across the ecosystem