OpenCLI Stack

Monorepo for xwzhangSZU's OpenCLI skill assets and runtime plugin adapters.

This repo aggregates everything we developed in-house around OpenCLI: the agent-side skills (how to use, author, repair, route OpenCLI commands) and the runtime adapters that ship .js files into ~/.opencli/clis/ for academic search and reimbursement workflows.

Out of scope. Third-party Agent Skills implementations (Anthropic's anthropics/skills, MiniMax's MiniMax-AI/skills, Karpathy's, etc.) live in their own repos and are not aggregated here. xwzhangSZU/claude-scholar-skills is also explicitly excluded — it depends on OpenCLI but is not part of this stack.

Layout

opencli-stack/
├── skills/                      # 9 agent-side skills (SKILL.md + references)
│   ├── opencli-usage/           # core: how to invoke OpenCLI for academic / browser / desktop / public-api
│   ├── opencli-explorer/        # adapter authoring: explore a new site's API
│   ├── opencli-oneshot/         # adapter authoring: 4-step quickstart from a single URL
│   ├── opencli-operate/         # operate websites in the user's logged-in Chrome
│   ├── opencli-repair/          # diagnose & fix broken adapters when sites change
│   ├── smart-search/            # site-level search router across 79+ adapters
│   ├── perplexity-cli/          # Perplexity REST CLI wrapper skill (no MCP dependency)
│   ├── opencli-scholar/  # CNKI / SSRN / Westlaw / arXiv unified entry
│   └── opencli-expense-orders/  # JD / Taobao reimbursement entry
├── plugins/                     # runtime adapter packages (history preserved via subtree)
│   ├── academic-search/         # was xwzhangSZU/opencli-plugin-academic-search
│   └── expense-orders/          # was xwzhangSZU/opencli-expense-orders
├── assets/
│   ├── manifest.json            # canonical inventory (schema v2)
│   └── README.md
└── tools/
    ├── sync-opencli-assets.sh   # central → live (~/.codex/skills, ~/.opencli/clis)
    └── install-all.sh           # one-shot install of every runtime plugin

Live targets (still populated by sync, not symlinked)

Consumer	Path	Source
Codex live skills	~/.codex/skills/*	skills/* via tools/sync-opencli-assets.sh --apply-codex-skills
OpenCLI runtime	~/.opencli/clis/*	plugins/*/install.sh (or tools/install-all.sh)
Claude Code skills	~/.claude/skills/*	symlinks to skills/* (manual, set up once)

Usage

# Inspect what's in the registry
cat assets/manifest.json

# Verify central vs live
bash tools/sync-opencli-assets.sh --check

# One-time install of every runtime plugin into ~/.opencli/clis/
bash tools/install-all.sh

# Sync agent-side skills to Codex
bash tools/sync-opencli-assets.sh --apply-codex-skills

# Or do everything at once
bash tools/sync-opencli-assets.sh --apply-all

History

• Seeded from xwzhangSZU/agents-skills@0151461 (the OpenCLI subset).
• plugins/academic-search/ is a git subtree add of xwzhangSZU/opencli-plugin-academic-search (43 commits preserved).
• plugins/expense-orders/ is a git subtree add of xwzhangSZU/opencli-expense-orders (8 commits preserved).
• The two predecessor runtime repos and the OpenCLI portion of agents-skills are now redirected here.

Versioning

The runtime plugins still declare their own minimum OpenCLI versions in assets/manifest.json (opencli_minimum). Keep this in sync when bumping plugin compatibility.

Excluded by policy

• xwzhangSZU/claude-scholar-skills — depends on OpenCLI but is not to be aggregated here. Edit there for academic writing flows.