Agent skill
codex-tools
Execute and manage Codex CLI tools including file operations, shell commands, web search, and automation patterns. Use for automated workflows, tool orchestration, and full automation with permission bypass.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/codex-tools
SKILL.md
Codex Tools Execution
Comprehensive patterns for executing Codex CLI tools safely and with full automation.
Last Updated: December 2025 (GPT-5.2 Release)
Full Automation Patterns
Maximum Automation
bash
# Complete bypass (zero friction)
codex exec --dangerously-bypass-approvals-and-sandbox "Organize project files"
# Safe automation (sandboxed)
codex exec --full-auto "Refactor module with tests"
# Custom automation
codex exec -a never -s workspace-write "Controlled automation"
Automated Workflows
bash
#!/bin/bash
# Complete project setup automation
setup_project() {
local name="$1"
local type="$2" # react, node, python, etc.
codex exec --dangerously-bypass-approvals-and-sandbox \
--search \
"Create $type project '$name' with:
1. Industry-standard directory structure
2. Configuration files (ESLint, Prettier, etc.)
3. Git initialization with proper .gitignore
4. README with setup instructions
5. CI/CD workflow (GitHub Actions)
6. Docker setup with multi-stage build
7. Environment variables template
8. Comprehensive tests
9. Documentation"
}
# Usage
setup_project "my-app" "react"
Batch Processing
bash
#!/bin/bash
# Process multiple files with full automation
batch_process() {
local pattern="$1"
local operation="$2"
codex exec --dangerously-bypass-approvals-and-sandbox \
--json \
"For each file matching $pattern:
1. $operation
2. Preserve formatting
3. Run tests
4. Fix any issues
Return JSON with changes summary"
}
# Examples
batch_process "*.js" "add JSDoc comments and type hints"
batch_process "*.test.ts" "improve test coverage to 100%"
Tool Categories
File Operations
bash
# Read and analyze
codex exec --json "List all functions in ./src with their complexity" > analysis.json
# Modify files
codex exec --dangerously-bypass-approvals-and-sandbox \
"Add error handling to all async functions in ./src"
# Generate files
codex exec --dangerously-bypass-approvals-and-sandbox \
"Generate API documentation from code"
# Organize files
codex exec --full-auto "Organize imports and exports across project"
Shell Commands
bash
# Run tests
codex exec --dangerously-bypass-approvals-and-sandbox \
"Run all tests and fix failures automatically"
# Install dependencies
codex exec --full-auto "Analyze dependencies and update to latest stable"
# Build and deploy
codex exec --dangerously-bypass-approvals-and-sandbox \
"Build optimized production bundle and run checks"
Web Search
bash
# Research-driven development
codex exec --search --dangerously-bypass-approvals-and-sandbox \
"Research best practices for GraphQL and implement schema"
# Technology comparison
codex exec --search --full-auto \
"Compare REST vs GraphQL vs gRPC and recommend for our use case"
Safety Patterns
Backup Before Execution
bash
#!/bin/bash
backup_and_execute() {
local task="$1"
# Git backup
git stash push -m "pre-codex-$(date +%s)"
if codex exec --dangerously-bypass-approvals-and-sandbox "$task"; then
echo "Success! Backup: git stash list"
else
echo "Failed! Restoring..."
git stash pop
return 1
fi
}
Scoped Automation
bash
# Limit to specific directory
codex exec --dangerously-bypass-approvals-and-sandbox \
-C ./src/auth \
"Only modify files in this directory"
# Add writable directories
codex exec --dangerously-bypass-approvals-and-sandbox \
--add-dir ./docs \
--add-dir ./tests \
"Can write to workspace, docs, and tests"
Complete Automation Examples
Automated Testing Workflow
bash
#!/bin/bash
automate_testing() {
codex exec --dangerously-bypass-approvals-and-sandbox \
--json \
"Complete testing automation:
1. Analyze code coverage
2. Generate missing unit tests
3. Generate integration tests
4. Generate e2e tests
5. Run all tests
6. Fix all failing tests
7. Achieve 100% coverage
8. Generate coverage report"
}
Automated Refactoring
bash
#!/bin/bash
automate_refactoring() {
local module="$1"
codex exec --dangerously-bypass-approvals-and-sandbox \
"Comprehensive refactoring of $module:
1. Analyze code quality
2. Apply modern patterns
3. Improve performance
4. Add error handling
5. Update tests
6. Run all tests
7. Fix any issues
8. Generate documentation"
}
Related Skills
codex-cli: Main integrationcodex-auth: Authenticationcodex-chat: Interactive sessionscodex-review: Code reviewcodex-git: Git workflows
Didn't find tool you were looking for?