Runex

安装 ​

三步：下载引擎 → 初始化 → 装进你的 Agent。全程在本地，不上云、不需要账号。

开始之前 ​

  • Python 3.12 – 3.13（python3 --version 看一下）
  • 一个你在用的 Agent：Claude Code / Codex / OpenCode / OpenClaw 任一
  • 会粘贴一行命令并回车

第 1 步 · 下载并安装引擎 ​

Runex 以 whl 包的形式在官网分发——到官网下载页拿到 runex-*.whl，然后本地安装它：

bash
pip install ~/Downloads/runex-*.whl
# 或者用 uv（推荐，给 CLI 工具单独隔离）：
# uv tool install ~/Downloads/runex-*.whl

没有 uv？

uv 是更干净的 CLI 安装方式。装它：curl -LsSf https://astral.sh/uv/install.sh | sh。不装也行，pip 一样能用。

第 2 步 · 初始化 ​

bash
runex init

这会在你电脑上建好本地数据库，并加载 17 个内置对象类型（人、项目、任务、目标……）。可以反复运行，不会重复创建。

第 3 步 · 装进你的 Agent ​

bash
runex skill install

这一步把 Runex 的六个技能放进你的 Agent，让它能发现并调用。各 Agent 的落点：

Agent技能装到哪里
Claude Code~/.claude/skills/runex/
Codex~/.codex/skills/runex/
OpenCode~/.config/opencode/（技能 + 命令文件）
OpenClaw按 OpenClaw 的 skill 安装流程加载 runex

完成后，重开一下你的 Agent，让它重新扫描技能。

验证：说第一句话 ​

不用敲命令验证——直接对你的 Agent 说：

text
你：记一下，这是我的第一条 Runex 笔记
Agent：已捕获 → 想法「这是我的第一条 Runex 笔记」

能看到它记下了，就装好了。接着看 快速上手。

如果想自己确认一下安装状态，也可以在终端跑：

bash
runex --version     # 看版本
runex doctor        # 看数据存在哪、有多少对象

想亲眼看看底层长什么样、东西都存哪了，看 命令行速览——全是只读命令，给你安全感。

数据在哪、隔离与升级 ​

  • 数据在你自己电脑上：默认在 ~/.runex/，本地一个数据库文件，断网也能用。

  • 多套环境隔离：给不同业务用不同目录——

    bash
    export RUNEX_HOME=~/我的工作区
runex init

  • 升级：到官网下载新的 whl，重装后再跑一遍 runex init && runex skill install（两条都可反复运行，安全）。