Skip to content

SETUP.md

Latest commit

 

History

History
184 lines (129 loc) · 4.65 KB

SETUP.md

File metadata and controls

184 lines (129 loc) · 4.65 KB
Raw

Windows, WSL, and Codex Setup

Use this guide to set up andamio-dev on Windows with WSL and OpenAI Codex. The goal is to make the Andamio skills available to Codex and verify the Andamio CLI on preprod.

The portable source of truth is skills/. The .agents/skills/ directory is only a local compatibility layer for agents that discover project skills there. It should contain symlinks, not copied skill files.

1. Install WSL And Clone The Repo

Install Ubuntu in WSL from PowerShell:

wsl --install -d Ubuntu

Open Ubuntu, then install basic tools:

sudo apt update
sudo apt install -y git curl build-essential

Clone the repo inside the Linux filesystem, not under /mnt/c, so symlinks and file watching behave normally:

mkdir -p ~/andamio
cd ~/andamio
git clone https://github.com/Andamio-Platform/andamio-dev.git
cd andamio-dev

2. Install And Verify Codex

Install Codex using the current OpenAI Codex instructions for Linux, then verify it inside WSL:

codex --version

Start Codex from the repo root:

cd ~/andamio/andamio-dev
codex

3. Configure Project Skills For Codex

The repo stores reusable skills in skills/. Codex discovers project skills from .agents/skills/, so create relative symlinks instead of copying files.

Run this from the repo root inside WSL:

mkdir -p .agents/skills
for skill in skills/*; do
  [ -f "$skill/SKILL.md" ] || continue
  name="$(basename "$skill")"
  ln -sfnT "../../skills/$name" ".agents/skills/$name"
done

Expected result:

.agents/skills/auth-setup/SKILL.md
.agents/skills/cli-guide/SKILL.md
.agents/skills/compound/SKILL.md
.agents/skills/cost-estimator/SKILL.md
.agents/skills/course-ops/SKILL.md
.agents/skills/assess-assignment/SKILL.md
.agents/skills/deliver-lesson/SKILL.md
.agents/skills/explore-api/SKILL.md
.agents/skills/learn/SKILL.md
.agents/skills/orientation/SKILL.md
.agents/skills/project-ops/SKILL.md
.agents/skills/start/SKILL.md
.agents/skills/troubleshoot/SKILL.md

Verify with:

find -L .agents/skills -maxdepth 2 -name SKILL.md -print | sort

Do not symlink from .claude/skills/ into .agents/. The canonical course skills live in skills/learn, skills/deliver-lesson, and skills/assess-assignment.

On WSL, symlinks work normally when the repo is stored under your Linux home directory. Avoid cloning this repo under /mnt/c for agent use.

4. Install The Andamio CLI

Install the CLI inside WSL and verify it:

brew install andamio-platform/tap/andamio
andamio --version

If Homebrew is not installed in WSL yet, install Homebrew for Linux first, then open a new shell and rerun the CLI install.

Set the CLI to preprod:

andamio config set-url https://preprod.api.andamio.io
andamio config show

Always start on preprod. Mainnet uses real ADA.

5. Configure Andamio Auth

Andamio uses two credentials:

Credential Command Needed For
API key andamio auth login --api-key <key> Read-only API access
Wallet JWT andamio user login Write operations and user-specific reads

Create an API key at:

https://preprod.app.andamio.io/api-setup

Then store it:

andamio auth login --api-key <your-ant-key>
andamio auth status

For write operations, log in with your wallet:

andamio user login
andamio user status

You need a Cardano preprod wallet with an Andamio Access Token before wallet login is useful. Use the Cardano preprod faucet for test ADA.

6. Verify Read Access

These commands should work with an API key and no wallet JWT:

andamio course list --output json
andamio project list --output json
andamio token list --output json
andamio tx types --output json

Without any credentials, the useful query surface is limited:

andamio user exists <alias>

7. Use Codex With The Andamio Skills

Once .agents/skills/ exists, restart Codex from the repo root. Then use natural prompts or name a skill directly:

$start

Use the course-ops skill. I want to create a new course on preprod.

Use the explore-api skill. What course queries can I make with only an API key?

Course creation requires API key, wallet JWT, preprod ADA, your Andamio alias, and initial teacher aliases. Ask Codex for /course-ops and provide:

course title:
owner alias:
initial teacher aliases:
environment: preprod

8. Course Learning In Codex

The /learn course harness is available to Codex through skills/learn. It runs inline in Codex instead of launching Claude-specific subagents. The lesson and assessment protocols are available as deliver-lesson and assess-assignment.