---
schema_version: 1
revision: "22ce5d34dbcb5a78"
id: "codex-resources"
title: "Resource access and tool directory"
---

# Resource access and tool directory

Use the portable repository for the examples, practice drills, shell snippets, and hook contracts. Review each command against the installed tool before running it.

## Download the portable repository

[Download the Git bundle](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle) · [SHA-256 checksum](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle.sha256)

```bash
curl -fL -o workshop-resources.bundle https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle
git clone workshop-resources.bundle workshop-resources
```

[Published recording](https://www.dropbox.com/scl/fi/3m5p2dwkx0imuyu0dq5os/GMT20260626-155513_Recording_gallery_1920x1080.mp4?rlkey=60j5649let6pt4fdxpggozv1q&st=qhbuo513&dl=0)

## Companion Links

| Resource | Use |
| --- | --- |
| [https://lapis-fossil-vsbc.here.now/](https://lapis-fossil-vsbc.here.now/) | Complete reference companion |
| [https://hollow-onyx-ajww.here.now/](https://hollow-onyx-ajww.here.now/) | Related published companion |
| [https://vowful-fable-32mh.here.now/](https://vowful-fable-32mh.here.now/) | Related published companion |


## Core Public Links

| Resource | URL |
| --- | --- |
| Oracle | [https://askoracle.sh/](https://askoracle.sh/) |
| Oracle repo | [https://github.com/johnlindquist/oracle](https://github.com/johnlindquist/oracle) |
| PackX package | [https://www.npmjs.com/package/packx](https://www.npmjs.com/package/packx) |
| Pack README | [https://github.com/johnlindquist/pack#readme](https://github.com/johnlindquist/pack#readme) |
| Codex Imps repo | [https://github.com/johnlindquist/codex-imps](https://github.com/johnlindquist/codex-imps) |
| Gog CLI | [https://gogcli.sh/](https://gogcli.sh/) |
| Inspiration Board variation example | [https://inspiration-board.pages.dev/variations/01-masonry-grid](https://inspiration-board.pages.dev/variations/01-masonry-grid) |
| Codex hooks docs | [https://developers.openai.com/codex/hooks](https://developers.openai.com/codex/hooks) |
| Codex app-server source | [https://github.com/openai/codex/tree/main/codex-rs/app-server](https://github.com/openai/codex/tree/main/codex-rs/app-server) |
| Prompt Builder repo | [https://github.com/johnlindquist/prompt-builder](https://github.com/johnlindquist/prompt-builder) |
| Local Fusion repo | [https://github.com/johnlindquist/fusion](https://github.com/johnlindquist/fusion) |
| OpenRouter Fusion product | [https://openrouter.ai/fusion](https://openrouter.ai/fusion) |
| OpenRouter Fusion model page | [https://openrouter.ai/openrouter/fusion](https://openrouter.ai/openrouter/fusion) |
| OpenRouter Fusion announcement | [https://openrouter.ai/blog/announcements/fusion-beats-frontier/](https://openrouter.ai/blog/announcements/fusion-beats-frontier/) |
| OpenRouter model fallback article | [https://openrouter.ai/blog/tutorials/keep-your-agent-running-when-models-disappear/](https://openrouter.ai/blog/tutorials/keep-your-agent-running-when-models-disappear/) |
| Agent Markers repo | [https://github.com/johnlindquist/agent-markers](https://github.com/johnlindquist/agent-markers) |
| Gemini app | [https://gemini.google.com/app](https://gemini.google.com/app) |
| Cypress docs | [https://docs.cypress.io/](https://docs.cypress.io/) |
| Playwright test assertions | [https://playwright.dev/docs/test-assertions](https://playwright.dev/docs/test-assertions) |
| here.now docs | [https://here.now/docs](https://here.now/docs) |
| Tailscale Funnel docs | [https://tailscale.com/kb/1223/funnel](https://tailscale.com/kb/1223/funnel) |
| Bun | [https://bun.sh/](https://bun.sh/) |
| jq | [https://jqlang.github.io/jq/](https://jqlang.github.io/jq/) |
| Homebrew | [https://brew.sh/](https://brew.sh/) |
| Script Kit | [https://scriptkit.com/](https://scriptkit.com/) |
| Zsh builtins manual | [https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html](https://zsh.sourceforge.io/Doc/Release/Shell-Builtin-Commands.html) |
| Zsh functions manual | [https://zsh.sourceforge.io/Doc/Release/Functions.html](https://zsh.sourceforge.io/Doc/Release/Functions.html) |
| Zsh startup overview | [https://zsh.sourceforge.io/Intro/intro_3.html](https://zsh.sourceforge.io/Intro/intro_3.html) |
| Zsh invocation manual | [https://zsh.sourceforge.io/Doc/Release/Invocation.html](https://zsh.sourceforge.io/Doc/Release/Invocation.html) |
| tmux manual | [https://man7.org/linux/man-pages/man1/tmux.1.html](https://man7.org/linux/man-pages/man1/tmux.1.html) |
| tmux wiki | [https://github.com/tmux/tmux/wiki](https://github.com/tmux/tmux/wiki) |
| Model Context Protocol | [https://modelcontextprotocol.io/](https://modelcontextprotocol.io/) |
| OpenAI Codex | [https://openai.com/codex/](https://openai.com/codex/) |
| yt-dlp | [https://github.com/yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp) |
| FFmpeg docs | [https://ffmpeg.org/documentation.html](https://ffmpeg.org/documentation.html) |
| ffprobe docs | [https://ffmpeg.org/ffprobe.html](https://ffmpeg.org/ffprobe.html) |


## Bundled Skills

| Skill | Bundled Path | What To Ask For |
| --- | --- | --- |
| Oracle PackX | `skills/oracle-packx/SKILL.md` | Bundle relevant repo context with PackX, send it to Oracle, and turn the result into an implementation plan or review |
| Oracle PackX references | `skills/oracle-packx/references/` | Quick and deep PackX reference material |
| Oracle Video | `skills/oracle-video/SKILL.md` | Analyze a recording or walkthrough through Gemini browser mode and produce evidence-backed follow-up material |
| Oracle Video process | `skills/oracle-video/references/repeatable-video-followup-process.md` | Repeatable video follow-up workflow with source hashes, probes, transcript evidence, and omissions pass |
| Fusion | `skills/fusion/SKILL.md` | Run a local model council, wait for `summary.json` and `final.md`, then treat the council output as advisory |
| Web Choices | `skills/web-choices/SKILL.md` | Present generated options in a small review UI, collect structured feedback, and resume from saved JSON |


## Zsh And Shell Materials

| Path | Use |
| --- | --- |
| `zsh/README.md` | Overview of the agent-safe zsh startup files and checks |
| `zsh/.zshenv` | XDG `ZDOTDIR` bootstrap example |
| `zsh/.zprofile` | Login-shell bridge for `zsh -lc` |
| `zsh/codex-env.zsh` | Agent-safe non-interactive shell bootstrap example |
| `zsh/conf.d/00-path.zsh` | Deterministic PATH assembly example |
| `zsh/conf.d/40-ai.zsh` | Small workshop loader for the focused function snippets |
| `zsh/conf.d/47-ai-fix.zsh` | Fusion-first `fix` helper example |
| `zsh/examples/local.zsh.example` | Public shape for machine-local overrides |
| `zsh/examples/codex-config-shell-environment-policy.toml` | Example `shell_environment_policy.set.CODEX_LOAD_ZSH_DSL` launch configuration |
| `zsh/tests/startup-regression.zsh` | Startup regression checks |


## Zsh Function Snippets

These snippets copy the named helper functions discussed in the workshop without copying whole private shell files.

| Snippet | Helpers Included |
| --- | --- |
| `zsh/functions/codex-launch-and-prompt-builder.zsh` | `x`, `xi`, `xfl`, `xfc`, `_codex_cmux_current_session_id`, `_codex_cmux_name_current_tab`, `_codex_prompt_builder_fork`, `_p_handoff_zsh`, `p-f`, `p-c`, `p-cm`, guarded app-server helper stubs |
| `zsh/functions/shell-introspection.zsh` | `funclist`, `funcwhere`, `funced` |
| `zsh/functions/fusion-fix.zsh` | `fix` |
| `zsh/functions/orchestration-helpers.zsh` | `muxai`, lazy-loader shapes for `agent_chain`, `ghost-save`, and `aicm` |
| `zsh/functions/script-kit-process-helpers.zsh` | `pksk`, `ksk` |


## Command-Line Tools And Concepts

| Tool Or Concept | Where It Appears |
| --- | --- |
| `zsh -lc` | Section 2 and Section 3 shell startup checks |
| `shell_environment_policy.set` | Section 2 Codex environment injection |
| `CODEX_LOAD_ZSH_DSL` | Local marker used to opt into selected zsh DSL loading |
| `prompt-builder` / `p` | Section 5 prompt composition and handoff |
| `--dry-run`, `--print-command`, `--print-prompt`, `--print-launch-json` | Prompt Builder preview and non-destructive checks |
| `--submit`, `--stdin`, `--name`, `--instructions`, `--developer-instructions` | Prompt Builder launch and prompt-shaping modes |
| `--handoff-command`, `--handoff-arg`, `--fork-from`, `--compact` | Prompt Builder handoff modes for zsh/Codex workflows |
| `CODEX_THREAD_NAME` | Prompt Builder and cmux tab naming helpers |
| `p-f`, `p-c`, `p-cm` | Prompt Builder handoff helpers |
| `xfl`, `xfc` | Codex fork and compact fork helpers |
| `cmux` | Addressable workspace, pane, surface, and process routing |
| `cmux identify`, `cmux rpc workspace.current`, `cmux top`, `cmux read-screen`, `cmux focus-pane` | cmux state inspection and routed session follow-up |
| `cmux-run-surface`, `cmux-fork-focused-codex`, `cmux-xport` | Local helper surface for pane launch, focused Codex fork, and transcript export |
| `tmux` | Terminal multiplexer comparison and fallback mental model |
| `muxai` | Quick tmux pane fan-out example |
| `agent_chain` | Gated multi-agent work-unit helper pattern |
| `imp`, `imps`, `imp-rg` | Isolated tool-agent commands |
| `imp -l`, `imps list`, `imps ps`, `imps doctor`, `imp --which` | Imp discovery, health, and routing checks |
| `imp --run`, `imp -q`, `imp --no-warm`, `imp --serve`, `imp --effort` | Imp direct-run, quiet, warm-runtime, server, and effort controls |
| `-<imp>` / `--<imp>` | Foreground route vs forked cmux route in the hook examples |
| `ffprobe` | Video metadata and verification probe |
| `yt-dlp` | Video metadata/download helper |
| `createAgentMarkers` | Browser debugging marker client |
| `DebugSession`, `DebugMoment`, `CapturedEvent`, `nearbyEventIds` | Agent Markers export schema concepts |
| `mark`, `event`, `export`, `download`, `clear`, `stop`, `onMarker` | Agent Markers client methods |
| `window.__AGENT_MARKERS__` | Test-runner export surface for Agent Markers |
| `fusion`, `fusion-med`, `fusion-high` | Local model-council CLI presets |
| `summary.json`, `final.md`, `panel-*.stdout.md`, `panel-status.json` | Fusion session artifacts to wait for and inspect |
| `browserAttachments: "always"`, `gemini-3-pro`, `END_OF_VIDEO_ANALYSIS` | Oracle Video browser-upload contract terms |
| source hash, `ffprobe`, transcript, keyframes/contact sheet, omissions pass | Oracle Video evidence lanes |
| `tailscale funnel`, `.ts.net`, `.token` | Web Choices phone-review tunnel and token-gated URL flow |
| `bun`, `jq`, `brew` | Common local tooling for the Svelte/mdsvex choice app and JSON checks |
| Script Kit, `pksk`, `ksk` | Script Kit process cleanup helpers mentioned in zsh examples |


## Hook And Orchestrator Examples

| Path | Use |
| --- | --- |
| `hooks/README.md` | Dash-prefix Imp hook setup and verification |
| `hooks/hooks.json.example` | Minimal Codex hook registration example |
| `hooks/imp-user-prompt-submit.py.template` | `UserPromptSubmit` hook template for foreground and forked Imp routing |
| `hooks/cmux-run-surface.example` | cmux pane-launch helper contract |
| `hooks/cmux-codex-session-registry.py.example` | Redacted contract for resolving a cmux surface to a Codex session id |


## Questions That Still Need Evidence

Review these questions before turning them into setup claims:

- AI-ready repository setup patterns for long-running AFK work
- Password-manager account/profile separation
- Current Codex Imps setup and public README coverage
- Reusable workspace layouts
- Newsletter, people, book, and podcast recommendations
- Public skill evaluation and personalization
- Hiring traits, AI fatigue, and ethics framing

## Private Config Boundary

Some local config is intentionally not copied verbatim:

- `~/.config/zsh/local.zsh`
- full `~/.codex/config.toml`
- files that contain provider-specific key helpers or secret wiring
- Fusion session artifacts under `~/.fusion/sessions/**`, which may contain prompts, source snippets, commands, stdout, stderr, and model responses

Use the examples under `zsh/examples/` for the public shape.

## Related resources

- [Companion reference](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle)

## Original references

- [Portable Codex workflow resources](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle)
