Turn a rough, plain-language coding request into a structured, tool-tuned prompt for an AI coding agent.

AgentForge extracts the real requirements, fills in missing edge cases, formats the prompt for the target agent's conventions, and runs it through a Quality Engine before returning it. Reach for this when a request is vague or under-specified and you want a sharper prompt before handing it to a coding agent.

Args:

• request (string, required): the coding task in plain language, 1-4000 chars.

• target_tool (string): one of claude-code, codex, cursor, aider, continue, windsurf, kimi, generic. Default: claude-code.

• style (string): plan-first, direct-edit, or explore-first. Default: plan-first.

Returns the refined prompt as text. structuredContent additionally carries: { "prompt": string, "tier": "free" | "pro", "quality": { "score": number, "max_score": number, "passed": boolean } | null, "usage": { "used_today": number, "limit": number | null } }

Errors are returned as text, e.g.:

• "API key not configured" — set AGENTFORGE_API_KEY.

• "invalid or revoked API key" (401) — check the key at agentforge.sciscale.org.

• "daily free limit reached" (429) — upgrade to Pro for unlimited calls.