Codex Deck Flow

Trust Score 86/100

Operator client for orchestrating persistent multi-agent coding workflows backed by a JSON workflow file under ./.codex-deck/ with strict create/validate/trigge

triggers:codex-deck-flowcreate workflowvalidate workflowdaemon-sendtrigger workflow

GitHub SKILL.md

What it does

Codex Deck Flow is an operator skill that controls a background daemon to manage persistent multi-agent coding workflows. It creates, validates, reconciles, and triggers JSON-based workflows stored under ./.codex-deck/, and issues single control messages to the daemon rather than acting as the orchestrator itself.

When to use it

Use when the user requests persistent workflow orchestration (task dependencies, per-task Codex sessions, git worktree isolation) or explicitly names $codex-deck-flow/codex-deck-flow. Also use for daemon control messages, status, and merge previews where explicit merge application is gated by user consent.

What's included

Scripts: several implementation scripts under scripts/ (workflow.py, daemon.py, daemon_client.py, codex_resume_noninteractive.py, etc.)
References: extensive references/ directory for commands, authoring rules, runbooks, scheduler guidance, and agent-flow design.
Instructions: operational mode, strict task-creating mode with exact tagging for approvals/questions, routing by intent (create -> validate -> show -> trigger), and integration boundaries.

Compatible agents

Fits Codex/Copilot/Gemini-style agent environments and any runtime that can run a background daemon and accept control messages. Best in platforms that support git worktrees and isolated task execution.

Audit Summary

Codex-deck-flow is a sophisticated multi-agent workflow orchestrator for Codex CLI sessions, using a daemon-based architecture with JSON workflow files, git worktree isolation, and explicit merge flows. The SKILL.md is comprehensive with clear routing logic and strict activation contracts. Scripts are well-written Python with proper type hints and error handling, but most fail in isolation due to inter-module imports (daemon_client, workflow). Only daemon_client.py runs standalone successfully. The tool fills a niche but growing need for persistent multi-agent coding workflows.

Watch Out

Scripts must be run from their directory or with proper PYTHONPATH — cross-module imports (daemon_client, workflow) will fail otherwise
Requires Codex CLI installed and configured for full functionality
Hardcoded 'danger-full-access' sandbox mode — appropriate for development workflows but worth noting
Daemon binds to localhost only with auth token — good security posture

Notes

Well-architected skill with production-quality code. Security-conscious design (localhost binding, auth tokens, chmod 0o600 on state files). Cross-module imports prevent isolated testing but are fine in normal usage. Niche but real utility for multi-agent Codex workflow orchestration.

Information

Repository: codex-deck
Stars: 8

Trust Score

Overall86

Security93

Code Quality76

Architecture82

Usefulness58

Related Skills

Development Worktree

Create an isolated git worktree for feature work, auto-run project setup, and verify a clean test baseline before development.

ds-fix — data-science mid-analysis fixer

Orchestrates diagnosis and targeted fixes mid-analysis: diagnose root cause, apply fixes with output-first verification, and update project learnings.

Readwise Reader Document Management

Manage Readwise Reader documents: list, save, search, move, tag, highlight, export and bulk-edit via official and custom CLIs.

Bounty Hunter — Atlas

Persona skill: 'Atlas' — a profit-focused developer persona for discovering, evaluating and executing paid bounties or freelance tasks with ROI-aware workflows.

Junshi — Research Advisor

Daily strategic research advisor that scans arXiv/venues, digests papers, and proposes bold, ranked research ideas tailored to the user's profile.

Full Stack Builder

End-to-end builder that scaffolds, implements, tests, and optionally deploys web and API applications from a natural-language specification.

ezBookkeeping API Tools

Command-line API tools for ezBookkeeping: record and query transactions, retrieve accounts/categories/tags, and fetch exchange rates for self-hosted personal fi

Feishu Voice Sender

Convert MP3s and send them as native Feishu voice messages (playable voice clips) to users or groups.

Back to Skills