/aiagent-tooling-setup

name: aiagent-tooling-setup
description: "ai-agent-camp用のCodexツーリングを設定するスキル。 「MCPサーバーを設定」「フックをインストール」「Codexの設定」「ツールセットアップ」「Codex CLIのインストール」等のリクエストで発動。"
version: 1.0.0
author: AI Brain Partners
dependencies: []
triggers:
  - aiagent-tooling-setup
  - MCPサーバー設定
  - フックをインストール
  - Codexの設定
  - ツールセットアップ
  - Codex CLI
  - tooling setup

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.