$dirxv0.1

DIRX(1)General Commands ManualDIRX(1)

Agent 通向互联网的治理入口

navigate · gate · audit — 5 个命令，访问整个互联网。每次调用，策略管控、可解释、可追溯。

dirx@web — /net
pid:1 tty:s000
  ┌──────────────────────────────────────┐
  │  试试输入命令:                       │
  │                                      │
  │  $ ls /net/                          │
  │  $ cat /net/api.github.com/repos     │
  │  $ write /net/api.github.com/issues  │
  │                                      │
  │  或点击上方命令按钮                  │
  └──────────────────────────────────────┘
dirx $

选择一个执行结果查看 Spec

0 blockss · idledirx v0.1.0 · web preview

SYNOPSIS

Spec · Policy · Trace

别的网关只做代理。DirX 做治理 — 每次调用都生成可验证的规格、强制执行的策略、可回放的追踪。

DIRnavigate

所有互联网 API 映射为路径树。ls 浏览、cat 读取、grep 搜索 — 路径即地址。

$ dirx ls /net/api.github.com/

repos/ users/ orgs/ issues/ actions/

POLICYgate

路径级 + 动作级策略引擎。拒绝返回可解释原因。write/rm 自动标记高风险。

$ dirx policy show /net/prod/*

deny: write, rm (scope: team, risk: high)

AUDITtrace

每次外部操作生成 trace_id。完整请求时间线，可导出、可验证。

$ dirx trace tx_8f3a2b

resolve→auth→request→response 42ms OK

NAMESPACE

/net/*

统一路径空间。一个 JWT — 路径即地址、即权限边界、即审计对象。每次请求：认证 → 策略 → 执行 → 审计。

45+ APIs · 400+ endpoints · 策略管控

NAMEPATHENDPOINTS
GitHub/net/api.github.com/1,523
Cloudflare/net/api.cloudflare.com/2,591
OpenAI/net/api.openai.com/89
Discord/net/discord.com/227
DigitalOcean/net/api.digitalocean.com/345
Weather.gov/net/api.weather.gov/42

SECURITY

密钥永不触达 Agent

三级凭证查找：本地 → 密钥管理器 → vault。网关在调用时自动注入。

L0
~/.dirx/keys

本地凭证存储。chmod 0600。除非明确同步，否则永不离开本机。

$ dirx keys set api.openai.com --token sk-...
L1
1Password / Bitwarden

外部密钥管理器集成。你现有的 vault 成为唯一真实来源。

$ dirx keys link --provider 1password
L2
DirX Vault

网关同步的 BYOK vault。AES-256-GCM 加密。Agent 作用域，可审计。

$ dirx keys set --sync api.openai.com

FOR API PROVIDERS

让你的 API 被 Agent 发现

三条命令完成接入。生成人机可读文档，注册到路径空间。

1.
$ npm install -g @dirxai/cli

全局安装 CLI

or: brew install dirxai/tap/dirx

2.
$ dirx init && dirx claim <domain>

扫描 API 端点，通过 DNS TXT 认领所有权

3.
$ dirx generate && dirx register

生成 DIR.md + dir.json，注册到路径空间

     _ _
  __| (_)_ ____  __
 / _` | | '__\ \/ /
| (_| | | |   >  <
 \__,_|_|_|  /_/\_\

DirX

Direction — The right path.

不是抽象掉 API 生态的复杂性。
也不是把它原样暴露。
Agent 与互联网之间，恰到好处的一层。