agentsys for Codex CLI
Professional-grade slash commands adapted for OpenAI's Codex CLI.
Overview
agentsys for Codex CLI
Professional-grade slash commands adapted for OpenAI's Codex CLI.
Quick Install
git clone https://github.com/agent-sh/agentsys.git
cd agentsys
./adapters/codex/install.sh
Prerequisites
- Codex CLI - Install from developers.openai.com/codex/cli
- Node.js 18+ - Download from nodejs.org
- Git - Download from git-scm.com
- GitHub CLI (
gh) - For PR commands (install:brew install ghor see cli.github.com)
Available Commands
/deslop - AI Slop Cleanup
Remove debugging code, old TODOs, and other AI slop.
codex
> /deslop
> /deslop apply
> /deslop apply src/ 10
What it does:
- Scans for console.logs, print statements, old TODOs
- Generates report or auto-applies fixes
- Runs verification tests
- Preserves functionality with minimal diffs
/next-task - Intelligent Task Prioritization
Discover what to work on next with AI analysis.
codex
> /next-task
> /next-task bug
> /next-task --include-blocked
What it does:
- Analyzes GitHub Issues (required)
- Validates tasks aren't already implemented
- Scores by impact, urgency, effort
- Provides top 5 recommendations with evidence
Requires: GitHub CLI (gh)
/audit-project - Multi-Agent Code Review
Comprehensive review with specialized AI agents.
codex
> /audit-project
> /audit-project --recent
> /audit-project --domain security
> /audit-project --resume
What it does:
- Deploys 10 specialized agents
- Adapts to your tech stack
- Finds bugs, security issues, performance problems
- Iterates until no open issues remain
/ship - Complete PR Workflow
Ship from commit to production with validation.
codex
> /ship
> /ship --strategy rebase
What it does:
- Commits changes with AI message
- Creates PR with description
- Waits for CI to pass
- Runs quality reviews
- Merges to main
- Deploys to dev/prod
- Validates deployments
- Auto-rollback on failure
Requires: Git, GitHub CLI (gh)
Installation Details
The installer:
- Creates
~/.codex/skills/<skill>/SKILL.mdfor each skill - Copies command files with path adjustments
- Installs shared libraries (platform detection, patterns)
- Creates environment setup scripts
File Structure
~/.codex/skills/
├── next-task/
│ ├── deslop.md
│ ├── next-task.md
│ ├── audit-project.md
│ └── ship.md
├── lib/
│ ├── platform/
│ │ ├── detect-platform.js
│ │ └── verify-tools.js
│ ├── patterns/
│ │ ├── review-patterns.js
│ │ └── slop-patterns.js
│ └── utils/
│ └── context-optimizer.js
├── env.sh
└── README.md
Usage Examples
Clean up debugging code
codex
> /deslop apply
# Changeset 1/5: Remove console.log statements
# - src/app.js: Removed 3 console.log calls
# [OK] Tests passed
#
# Summary: 5 files changed, 23 lines deleted
Get next priority task
codex
> /next-task
# Top 5 Priority Tasks:
#
# 1. [High Impact] Fix login timeout on mobile
# Score: 9.2/10 (Impact: 10, Urgency: 9, Effort: 3)
# Status: not-started (no code found)
Ship a feature
# Make your changes
git add .
codex
> /ship
# [OK] Commits with AI message
# [OK] Creates PR with context
# [OK] Waits for CI
# [OK] Reviews code
# [OK] Merges to main
# [OK] Deploys and validates
Codex-Specific Notes
Custom Prompt Integration
These commands integrate with Codex's custom prompt system. You can also create shortcuts by adding to your Codex config.
Multi-Agent Differences
Codex CLI may handle multi-agent workflows differently than Claude Code. Commands will adapt to available capabilities.
Built-in Commands
Use alongside Codex's built-in commands:
/diff- View Git diff/review- Codex's native review/compact- Summarize conversation/model- Switch models
agentsys commands complement these.
Platform Support
Auto-Detected CI Platforms
GitHub Actions · GitLab CI · CircleCI · Jenkins · Travis CI
Auto-Detected Deployment Platforms
Railway · Vercel · Netlify · Fly.io · Platform.sh · Render
Auto-Detected Project Types
Node.js · Python · Rust · Go · Java
Updating
To update commands:
cd /path/to/agentsys
git pull origin main
./adapters/codex/install.sh
Troubleshooting
Commands not showing up
- Restart Codex CLI
- Check installation:
ls ~/.codex/skills/ - Re-run installer
Path errors
Re-run installer to fix path substitutions:
./adapters/codex/install.sh
Node.js not found
Ensure Node.js 18+ is installed:
node --version # Should be v18.0.0 or higher
GitHub CLI authentication
gh auth login
gh auth status
Support
- Repository: https://github.com/agent-sh/agentsys
- Issues: https://github.com/agent-sh/agentsys/issues
- Codex CLI Docs: https://developers.openai.com/codex/cli
Resources
Made for the Codex CLI community