codex-setup
/codex-setup
Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.
- Author
- kangig94 ↗
- Repository
- obsidian-para-zk ↗
- Licence
- MIT
- Last repository change
- 25.07.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 25.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/install-codex-agents.mjs
What it does and when to use it
Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.
Original author description
Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.
How it works
- Workflow
- Installer Options
SKILL.md preview
---
name: codex-setup
description: Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.
---
# Codex Setup
Install PARA-ZK custom agents into the user's Codex agent directory. This bridges
the plugin's shared `clients/agents/*.md` agent definitions into Codex's
`~/.codex/agents/*.toml` custom-agent format.
## Workflow
1. Run the bundled installer. Do not block installation on Optsidian or its MCP
server: those are runtime command transports, not installer dependencies.
```bash
node clients/skills/codex-setup/scripts/install-codex-agents.mjs
```
When running from an installed plugin cache, resolve the path relative to this
`SKILL.md` file:
```bash
node <this-skill-dir>/scripts/install-codex-agents.mjs
```
2. Check and report which runtime command transport the installed agents can use,
without failing or undoing the installation:
- Prefer `mcp__optsidian__command_run` when it is available in the current
session.
- Otherwise use `optsidian` from `PATH`.
- Otherwise fall back to the native `obsidian` CLI from `PATH`.
- If none is available, warn that vault-working agents such as `wiki-weaver`
cannot run yet. The agent files are still installed successfully.
3. Report the installed, updated, unchanged, and warning lines from the script.
4. Tell the user to restart Codex or start a new thread before expecting the new
agent names to appear.
## Installer Options
- `--dry-run`: print what would be written without modifying files.
- `--force`: accepted for compatibility with older instructions; installs now
overwrite existing agent TOML files by default.
- `--out-dir <path>`: write to a custom Codex agent directory instead of
`${CODEX_HOME:-~/.codex}/agents`.
- `--source-dir <path>`: read agent markdown files from a custom directory instead
of the plugin's `clients/agents`.
Default installs are destructive for managed agent names: an existing different
TOML file at the generated target path is overwritten with the bundled agent
definition. Use `--dry-run` to preview writes.
Files in this package (2)
- SKILL.md 2 KB
- scripts/install-codex-agents.mjs 7 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · kangig94/obsidian-para-zk | 100 | MIT |
| sd0xdev/sd0x-harness | 95 | MIT |
Database snapshot: 13.11.2026 · package version dcd1052f4bb6 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 81codex-agents-bootstrap
Install or refresh custom agents shipped by solopreneur-family plugins in the Codex user agents directory. Use after installing, updating, enabling, or disabling a solopreneur-family plugin, or when the user asks to bootstrap, install, refresh, or diagnose Codex agents. This is… - 100wiki-ingest
Use when ingesting canonical PARA-ZK sources into the LLM-Wiki — per-import, delta, uncited, or targeted re-ingest. - 86wiki-ingest
把 agent 会话里的知识摄入 Meiqiu 知识库(个人 LLM Wiki)。当用户要求把会话摄入知识库、提炼知识到 wiki 时使用。 - 100codex-to-cc
One-shot conversion of a Codex plugin to Claude Code format. Use when asked to convert a Codex plugin to Claude Code, add CC support for a Codex plugin, or reverse-port a plugin from Codex. - 100custom-agent-definitions
Write and configure custom agent definitions in Claude Code agents/ directory. Use when creating an agent .md file, defining a specialized agent, or configuring agent tools. - 100bootstrap
Bootstrap an LLM-maintained wiki for the current project. Use when a user asks to create, initialize, or refresh a project wiki, LLM wiki, QMD wiki, or codebase knowledge base for Claude Code, Codex, or Pi.