玛莎克丽

终端第一客户端 玛莎 AI平台.

管理代理,功能,工作流程,任务,文档,以及更多来自您外壳的. 为人类开发者和外部代理机床(Claude Code、Ork、CrewAI、Pydantic AI等)设计——见 代理一体化 见下文.

安装

按要求运行( 建议)

npx -y @aiaiai-pt/martha-cli@latest --help

从 CI 或代理运行时间调用时按下一个版本 :

npx -y @aiaiai-pt/[email protected] agents list --json

全球安装

npm i -g @aiaiai-pt/martha-cli
martha --version

要求节点.js >= 22.

快速启动

# 1. Configure a profile — writes ~/.martha/config.yaml
martha init                       # interactive (defaults to cloud preset)
martha init --preset local        # localhost dev stack
martha init --no-interactive --name staging --api-url https://...   # scripted

# 2. Authenticate
martha auth login                 # browser flow (PKCE)
martha auth login --username u --password p   # headless
export MARTHA_TOKEN=eyJhbGc...    # bypass login (CI / one-off)

# 3. Verify everything is wired up
martha doctor                     # API + Keycloak + token + version skew

# 4. Run something
martha agents list
martha functions list --json | jq '.[].name'
martha chat my-agent "Summarise the latest task in tracker INGEST-42"

完整命令引用 : martha --help (或任何子命令) --help) (中文(简体) ).

配置

配置文件为 ~/.martha/config.yaml。每个配置文件定义:

current_profile: default
profiles:
  default:
    api_url: https://martha.nomadriver.co
    keycloak_url: https://auth.nomadriver.co
    keycloak_realm: frank
    auth_type: oidc

覆盖每个命令 :

martha --profile staging agents list
martha --api-url http://localhost:8080 status
MARTHA_PROFILE=cloud martha tasks list

自动优先

1. MARTHA_TOKEN env var (raw JWT, 绕过一切)
2. MARTHA_CLIENT_ID + 键 MARTHA_CLIENT_SECRET (客户证书补助金,自动更新)
3. 配置文件存储的符号来自上一个 martha auth login
4. 基于浏览器的 OIDC( 只交互)

JSON 输出

每个命令都支持 --json 用于机器可读输出。 管道时使用 jq 或从脚本/代理人调用:

martha agents list --json | jq '.[] | {name, status}'

退出代码 : 0 成功 · 1 一般错误 ^ 2 认证失败 3 找不到.. 4 鉴定 · 5 冲突(409).

在巴斯频道放一个特工

一个命令, 不安装自己的命令 :

npx -y @aiaiai-pt/martha-cli channels install-harness buzz

然后进入 巴兹 桌面 : 新代理 ~ 运行时间"玛莎". 命令将 Martha 注册为 ACP 运行时间, 将定义写入 Buz 自己的 app-data 目录 —— 任何 ACP 代理的辅助路径, 没有 PR 和 插件 .

有个特工来做 离开巴斯家 编辑代理 空 :

martha principals bootstrap --mode agent --agent support \
  --prompt "You answer support questions from our handbook." \
  --intents rag --collections "Handbook" --save-profile support
martha channels install-harness buzz --use-profile support

简介 名称 定义; 证书在 ~/.martha/credentials.json (0600) (中文(简体) ). 在信任它之前检查所有东西 martha channels preflight buzz --agent support --relay wss://…,其中列出每个缺失的前提条件并退出非0。 全向导 : https://docs.martha.nomadriver.co/buzz 页面存档备份,存于互联网档案馆。 。 。 .

代理一体化

这个包装了一种能提高特务技能的参考 skills/martha-cli/SKILL.md 描述每个命令、JSON合同和概念原始(租户、代理人、功能、任务等)。 特工带可以直接拉出:

# Print the skill to stdout (works for npm i -g and npx)
martha skill

# Seed an agent's prompt context
npx -y @aiaiai-pt/martha-cli@latest skill | head -200

稳定

0.x 发布可能会在小版本之间更改CLI旗或JSON输出. 在 CI/代理上下文中设定一个版本 :

npx -y @aiaiai-pt/[email protected] ...

1.0.0 将致力于稳定的契约——见 追踪问题。 。 。 .

发展

cd martha-cli
bun install
bun run dev -- agents list      # run from source
bun run build                   # produce dist/index.js
bun run test:run                # unit + integration tests
MARTHA_LIVE=1 bun run test:run tests/live/  # live tests against local Martha

CLI住在美国 西欧佩科/马特哈 单重 martha-cli/公关欢迎.

许可证

麻省理工学院