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.