Engineering workflows for Claude Code and Codex: investigate a GitHub issue, make a focused fix, verify it, and open a pull request. Nexus also includes specialist debugging, review, reliability, and planning guidance.
Plugin-first AI terminal workspace for Codex and Claude Code with planning, CI/CD debugging, reusable agents, skills, TODOs, and MCP tool integrations.
Open a local repository, then invoke the workflow:
/nexus:software-engineer fix issue #123 in the current repository and raise a PR
Or supply a repository directory and a bug in chat:
Use software-engineer in /path/to/repo. Saving a profile with an empty display name crashes. Reproduce it, fix it, run the relevant checks, and raise a PR.
With only a directory, the workflow inspects GitHub issues and selects a bounded, actionable candidate using its documented selection rules. It checks for existing work, protects unrelated edits, implements and verifies the fix, and opens a focused PR when authentication and repository permissions permit. It reports blocked checks honestly and does not merge or deploy.
Prerequisites: Git, a local checkout, a supported AI host, and an authenticated GitHub connector or gh CLI with repository access for issue retrieval and PR creation. Use gh auth status to check CLI authentication. The workflow follows repository instructions and uses the project's own validation commands. Node.js 18+ is needed only for the bundled helper scripts; the website has its own npm dependencies.
Codex installation and use
With a Codex CLI that supports codex plugin (local installation tested on 0.157.1):
You can use a local clone path as the marketplace source instead of the GitHub slug. The recorded smoke checks cover clean local-path installation and removal in temporary profiles; remote fetching, model-driven invocation, and upgrades remain separate checks.
Select software-engineer from the installed skill list or ask Codex to use it by name. Exact namespaced invocation and component routing depend on the host. If your version lacks native plugin support, upgrade or point your host at the skill instructions in a local clone. Third-party installers are separate tools with their own compatibility and trust requirements.
Claude command syntax is not guaranteed; use the underlying instructions
Specialist agents
Claude agent definitions, tool declarations, and memory configuration
No claim of identical agent registration or persistent memory behavior
Global guidance
Managed block in ~/.claude/CLAUDE.md
Managed block in ~/.codex/AGENTS.md
GitHub and other tools
Configure host tools and credentials separately
Configure host tools and credentials separately
Tool permissions are enforced by the host. A workflow's instruction to stay read-only is not a security sandbox. Some agents inherit tools; others declare Bash access.
Optional global guidance
Installing skill files does not prove a bootstrap hook ran. From a cloned or installed Nexus directory, explicitly preview the selected runtime's changes:
Removing guidance does not uninstall plugin files. Use your host or installer's uninstall mechanism for that. See migration notes for the old singular AGENT.md filename and renamed skills.
Shipped catalog
This section and the website catalog are generated from manifests and source files. Examples below use Claude plugin invocation syntax; agents are selected by the host or requested by name.
Version 1.35.0 includes 11 skills, 14 Claude agents, and 2 commands.
Commit regenerated catalog and documentation alongside source changes. Structural validation checks packaging and references; it does not prove model behavior. The software-engineer skill includes evaluation scenarios for workflow review. For a release, perform the manual host smoke checks and record the host versions, installed revision, and results.
Privacy
The repository's helper scripts operate locally; they do not provide an adoption analytics collector. Nexus guidance, local TODOs, host-managed memory, and session information may contain sensitive work context. Review the specific workflow and configured host before running it.
AI hosts and connected services process information according to their own configuration and policies. GitHub issue/PR operations transmit selected content to GitHub; other connectors can send data to their respective services. Do not put secrets into issues, PRs, logs, or committed fixtures. Bootstrap changes runtime instruction files; preview and removal commands are documented above. Removing a managed block does not delete host conversations, memory, or external service data.
Contributing and support
Report a reproducible issue with the Nexus revision, host/version, expected behavior, actual behavior, and sanitized evidence. Never include tokens or private source without permission. Keep changes focused and include appropriate checks.
Plugin-first AI terminal workspace for Codex and Claude Code with planning, CI/CD debugging, reusable agents, skills, TODOs, and MCP tool integrations.
上次檢查時間:2026-10-26。 Plugin-first AI terminal workspace for Codex and Claude Code with planning, CI/CD debugging, reusable agents, skills, TODOs, and MCP tool integrations.