AI Agent Tooling Setup

Codex CLI は OpenAI が提供するターミナルベースの AI コーディングアシスタントです。

Use this skill when the user needs Codex-specific tooling guidance.

Workflow

1. Read docs/codex-mcp.md.
2. Identify whether the request is about repo tools, repo hooks, or MCP servers.
3. Prefer existing repo scripts over ad hoc shell instructions.
4. Keep the final answer focused on the exact tooling path the learner needs.

Repo Commands

• bash scripts/install_hooks.sh
• uv run python tools/check_command_paths.py
• uv run python tools/credential_manager.py status

Codex CLI Installation & Authentication

Installation

npm install -g @openai/codex
codex --version   # verify installation

Requires Node.js 18+.

Authentication

Set the OpenAI API key via environment variable:

export OPENAI_API_KEY="your-api-key-here"

Or add OPENAI_API_KEY=... to the repo .env file (never commit this file).

Recommended Runtime

Setting	Value	Reason
Sandbox	workspace-write	Restricts writes to the repo directory
Approval	on-request	Asks before external commands

Launch with:

codex -a on-request

Avoid danger-full-access for normal learning flows. See docs/codex-safety.md.

First-Time Flow

1. Install Codex CLI (npm install -g @openai/codex)
2. Set OPENAI_API_KEY
3. Open ai-agent-camp and run bash scripts/install_hooks.sh
4. Use aiagent-check-setup skill to verify environment
5. Start lessons via aiagent-lesson-runner skill

Reminders

• Keep project rules in AGENTS.md.
• Keep machine-specific settings in the Codex config layer.
• Avoid implying that Cursor command files are executable in Codex.