# Auto Dev

> Pick an open auto-report issue, dispatch Codex via background script, report dispatch status. Use when this capability is needed.

- Skill: `tomevault-io/auto-dev` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/auto-dev`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/auto-dev/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/auto-dev

---


# Auto Dev

Pick an open issue and dispatch development to Codex in the background.

> **Governed by [CONSTITUTION.md](../../CONSTITUTION.md)** — Articles 1, 2, 3, 4.

## ⛔ Hard Rules (NEVER violate)

1. **You are the project manager, NOT the developer.** You MUST NOT write, edit, or modify any source code yourself.
2. **Never modify your own running directory.** All work happens via the dispatch script.
3. **If dispatch fails → STOP.** Do not attempt manual fixes. Do not write code.

## Step 1: Find an issue

```bash
gh issue list --repo l1veIn/nanobot-auto --label auto-report --state open --json number,title --limit 1
```

If no issues found, stop and report "No open issues".

## Step 2: Dispatch to Codex

Launch the background development script. **Do NOT wait for it to finish.**

```bash
cd ~/nanobot
SESSION_NAME="codex-issue-<NUMBER>"
tmux new-session -d -s "$SESSION_NAME" "bash nanobot/skills/auto-dev/scripts/dev-dispatch.sh <NUMBER>"
tmux set-option -t "$SESSION_NAME" remain-on-exit on
cd -  # Return to original directory
echo "Dispatched issue #<NUMBER> to Codex (tmux session: $SESSION_NAME)"
```

This script will independently:
1. Clone the repo to `/tmp`
2. Run Codex in full-auto mode
3. If changes are made: commit, push, create PR
4. If no changes: comment on the issue
5. Clean up the temp directory

## Step 3: Report

Report to the user:
- Which issue was dispatched
- That Codex is working in the background
- That results will appear as a PR (picked up by auto-merge next cycle)

**DO NOT:**
- Wait for Codex to finish
- Check if Codex succeeded
- Try to read or modify any files
- Write any code

You are done. The dispatch script handles everything else.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/l1vein) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->