eforge-status

star 67

Check eforge run status and queue state via daemon tools

eforge-build By eforge-build schedule Updated 5/20/2026

name: eforge-status description: Check eforge run status and queue state via daemon tools disable-model-invocation: true

/eforge:status

Quick inline status check — queries the eforge daemon for current run state and queue contents.

Workflow

Step 0: Validate Config

Call eforge_config with { action: "validate" }.

  • If configFound is false, stop and tell the user: "No eforge config found. Run /eforge:init to initialize eforge in this project."
  • Otherwise, continue.

Step 1: Get Run Status

Call the eforge_status tool (no parameters needed).

  • If the response indicates no active sessions, report:

No active eforge builds. Use /eforge:build to enqueue work.

  • Stop here if no active sessions.

Step 2: Render Status

Parse the JSON response and display:

Session: {sessionId} Status: {status} (running / completed / failed)

Plan Progress

If the response contains plan-level status, render a table:

Plan Branch Status Dependencies
{planId} {branch} {status} {dependsOn}

Status values: pending, running, completed, failed, blocked, merged

Step 3: Queue State

Call the eforge_queue_list tool (no parameters needed).

Parse the response. If PRD files are found, display a summary:

Queue: {count} pending PRD(s)

For each pending PRD, show the title. If there are more than 5, show the first 5 and a count of remaining.

Step 4: Summary

If the overall status is running, show:

The daemon is processing the build in the background. Use /eforge:status again to refresh, or open the monitor dashboard for live details.

If the status is completed or failed:

  • Completed: "All plans completed successfully. Post-merge validation was included in the run."
  • Failed: Show which plans failed and suggest using /eforge:status again to refresh or checking the monitor dashboard.

Error Handling

Condition Action
Tool returns error Show the error, suggest running eforge daemon start manually

| Daemon not running | The daemon is not running. Tell the user to start it with eforge_daemon { action: "start" }, /eforge:restart, or eforge daemon start. |

| No config found | Tell the user: "No eforge config found. Run /eforge:init to initialize eforge in this project." | | Response is malformed | Report parse error, suggest running eforge status CLI directly |

Related Skills

Skill When to suggest
/eforge:init No eforge config found in the project
/eforge:build User wants to enqueue work for the daemon
/eforge:config Config validation fails or user wants to view/edit config
/eforge:status User wants to refresh build status
Install via CLI
npx skills add https://github.com/eforge-build/eforge --skill eforge-status
Repository Details
star Stars 67
call_split Forks 4
navigation Branch main
article Path SKILL.md
More from Creator
eforge-build
eforge-build Explore all skills →