MCP、Hosted API、そして AMCP サーフェス

# local sqlite memory
npx -y @nunchiai/[email protected] init --all --local --yes
npx -y @nunchiai/[email protected] activate --key sk_write_your_key --gateway-url https://gateway.nunchiai.com

# hosted memory
npx -y @nunchiai/[email protected] init --client codex,gemini-cli --key sk_write_your_key --gateway-url https://gateway.nunchiai.com --yes
npx -y @nunchiai/[email protected] init --list

# push local rule files (.cursorrules, CLAUDE.md, AGENTS.md, .cursor/rules/*, ...)
npx -y @nunchiai/nexus-mcp sync

# preview only (no write)
npx -y @nunchiai/nexus-mcp sync --dry-run

# local_lite: configure all detected clients for local SQLite
npx -y @nunchiai/[email protected] init --all --local --yes
npx -y @nunchiai/[email protected] activate --key sk_write_your_key --gateway-url https://gateway.nunchiai.com

# cloud tiers (trial_cloud / cloud_pro / team): configure selected clients only
npx -y @nunchiai/[email protected] init --client codex,cursor,gemini-cli --key sk_write_your_key --gateway-url https://gateway.nunchiai.com --yes

# inspect detection only
npx -y @nunchiai/[email protected] init --list

# preview changes without writing files
npx -y @nunchiai/[email protected] init --all --local --dry-run

# remove nexus-mcp config from all clients
npx -y @nunchiai/[email protected] init --remove --all --yes

[mcp_servers.nexus-mcp]
command = "npx"
args = ["-y", "@nunchiai/nexus-mcp"]

[mcp_servers.nexus-mcp.env]
NEXUS_STORAGE = "local"
NEXUS_AGENT_NAME = "codex"

curl -X POST https://gateway.nunchiai.com/v1/amcp/remember \
  -H "Authorization: Bearer sk_write_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "content": "Auth flow uses PKCE",
        "type": "decision",
        "scope": { "kind": "project", "id": "acme-web" }
      }
    ]
  }'

curl -X POST https://gateway.nunchiai.com/v1/amcp/recall \
  -H "Authorization: Bearer sk_write_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "auth decisions",
    "scope": { "kind": "project", "id": "acme-web" },
    "token_budget": 2000,
    "depth": "deep"
  }'

POST /v1/amcp/export
{
  "scope": { "kind": "project", "id": "acme-web" },
  "format": "json"
}

POST /v1/amcp/import
{
  "items": [ ... ]
}

DELETE /v1/amcp/memories/:id?scope[kind]=project&scope[id]=acme-web

POST /v1/memory/ingest
POST /v1/memory/hydrate
GET  /v1/memory/sessions
GET  /v1/memory/stats

npx -y -p @nunchiai/reference-agent@latest amcp-agent --help

export NEXUS_URL=https://gateway.nunchiai.com
export NEXUS_API_KEY=sk_write_your_key
export OPENAI_API_KEY=your_model_key

npx -y -p @nunchiai/reference-agent@latest \
  amcp-agent task "Inspect this repo and summarize the auth flow." --amcp-trace

export NEXUS_URL=https://gateway.nunchiai.com
export NEXUS_API_KEY=sk_write_your_key
export NEXUS_READ_ONLY_API_KEY=sk_read_your_key

npx -y -p @nunchiai/reference-agent@latest amcp-agent compliance

[AMCP] session     start ...
[tool] read_file  ...
[AMCP] remember    scope=project  "Session summary: ..."
[AMCP] session     close ... transient_deleted=1
<final natural-language summary>

PASS remember
PASS recall
PASS delete_denied
PASS soft_delete
PASS export_import_roundtrip
AMCP_COMPLIANCE_OK
AMP_COMPLIANCE_OK   # compatibility alias marker

LLM_API_KEY looks like a Nexus API key. Set a real OpenAI-compatible model key in OPENAI_API_KEY or LLM_API_KEY.

FAIL delete_denied: NEXUS_READ_ONLY_API_KEY is required for delete_denied compliance.