Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions .codex/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Codex Cloud Environment

Use these repo-local scripts when configuring the Codex cloud environment for `useorgx/skills`.

## Setup script

```bash
bash .codex/setup-cloud.sh
```

## Maintenance script

```bash
bash .codex/maintenance-cloud.sh
```

## Environment notes

- Python 3 is enough for the repo-level drift checker.
- No OrgX API secrets are required for static skill drift checks.
- Keep internet access limited to the setup phase unless a task explicitly needs external services.

## Verification commands

```bash
python3 scripts/check_skill_tool_drift.py
```
10 changes: 10 additions & 0 deletions .codex/cleanup-local-worktree.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
#!/usr/bin/env bash
set -euo pipefail

cd "${CODEX_WORKTREE_PATH:-$(dirname "${BASH_SOURCE[0]}")/..}"

if [ -f docker-compose.yml ] || [ -f docker-compose.yaml ] || [ -f compose.yml ] || [ -f compose.yaml ]; then
docker compose down --remove-orphans 2>/dev/null || true
fi

rm -rf .cache/tmp .next/cache .turbo .vitest .wrangler/tmp node_modules/.cache tmp
6 changes: 6 additions & 0 deletions .codex/maintenance-cloud.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
#!/usr/bin/env bash
set -euo pipefail

cd "$(dirname "${BASH_SOURCE[0]}")/.."

python3 --version
7 changes: 7 additions & 0 deletions .codex/setup-cloud.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail

cd "$(dirname "${BASH_SOURCE[0]}")/.."

python3 --version
python3 scripts/check_skill_tool_drift.py
10 changes: 10 additions & 0 deletions .codex/setup-local-worktree.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
#!/usr/bin/env bash
set -euo pipefail

cd "${CODEX_WORKTREE_PATH:-$(dirname "${BASH_SOURCE[0]}")/..}"

if [ -x .codex/maintenance-cloud.sh ]; then
bash .codex/maintenance-cloud.sh
else
echo "No .codex/maintenance-cloud.sh found; skipping local worktree setup."
fi
29 changes: 29 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# AGENTS.md

Guidelines for Codex and other agents working in `useorgx/skills`.

## Project

This repo contains OrgX skill definitions and protocol guidance for MCP-capable agents.

## Setup

For Codex cloud, use:

```bash
bash .codex/setup-cloud.sh
```

Maintenance script for cached environments:

```bash
bash .codex/maintenance-cloud.sh
```

## Verification

```bash
python3 scripts/check_skill_tool_drift.py
```

Run the drift checker before claiming skill changes are ready. It is the minimum proof that skill files still reference valid OrgX MCP tool names and required workflow gates.
Loading