Repository navigation
Build agent-first website and interactive plugin quickstart - #208
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e7f2477e94
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| <h1>Agents get better.<br><em>Together.</em></h1> | ||
| <p>Give Claude Code, Codex or another agent a task: improve this skill. AgentDescent plans the run, explores changes in parallel and returns a diff for you to review.</p> | ||
| <div class="hero-ctas"><a href="install/" class="exp-button primary">Use it in your agent <span>↗</span></a><a href="#lab" class="exp-button ghost">See it inside your agent <span>↓</span></a></div> | ||
| <div class="hero-command"><span>$</span><code>pip install agentdescent</code><button class="exp-copy" data-copy="pip install agentdescent" aria-label="Copy install command">Copy</button></div> |
There was a problem hiding this comment.
Point the hero install command at the plugin-capable checkout
The homepage now presents pip install agentdescent beside the agent-first workflow, but the published v0.5.0 package does not provide the current plugin workflow; the new quickstart itself requires cloning main and explicitly says to use that checkout for plugins. A new user following this prominent command therefore installs a release that cannot support the advertised Claude Code/Codex/OpenCode setup. Use the main checkout command here or clearly label this as a library-only stable install.
Useful? React with 👍 / 👎.
| await pause(580); | ||
| addMessage('tool', 'AGENTDESCENT · PLAN', 'Sample plan: 12 cases · 4 workers · up to 48 agent calls.', 'Please review the plan and cost before starting.'); | ||
| status.textContent = 'AWAITING APPROVAL'; toolLine.textContent = 'Plan ready · no run started'; | ||
| approve.textContent = 'Approve sample run ↗'; approve.hidden = false; phase = 1; start.disabled = false; |
There was a problem hiding this comment.
Disable restart while approval playback is running
After the plan is displayed, this re-enables the start button, and the approval handler never disables it again. If a user clicks “Start sample conversation” while the asynchronous approved run is animating, a second start handler clears the chat and resets phase, while the first handler continues appending START/STATUS/SHOW messages and overwriting the phase; the resulting conversation and approval state are interleaved. Keep the start control disabled until the approval handler finishes or cancel the previous playback before restarting.
Useful? React with 👍 / 👎.
| addMessage('user', 'YOU', 'The plan looks good. Start the sample run.'); | ||
| await pause(380); addMessage('tool', 'AGENTDESCENT · START', 'Started a background evolution run.'); | ||
| await pause(550); addMessage('tool', 'AGENTDESCENT · STATUS', 'Workers proposed edits; the aggregator evaluated the candidate.'); | ||
| await pause(550); addMessage('tool', 'AGENTDESCENT · SHOW', `Proposed diff: + ${kinds[activeKind].example}.`, 'The real artifact remains untouched until you approve apply.'); |
There was a problem hiding this comment.
Preserve the artifact selected when the run starts
If the user changes the artifact preset after starting a conversation but before approving or while the animation runs, this reads the mutable global activeKind, so the SHOW message can describe a code or prompt change even though the initial request and plan were for a skill. Snapshot the selected kind for the active conversation or lock the preset controls until playback completes.
Useful? React with 👍 / 👎.
Summary
Preview
Private preview: https://agentdescent-live-preview.dapper-pine-9474.chatgpt.site
Validation
mkdocs build --clean --strictwith the social-card plugin disabled locally because the execution network blocks Google Fonts. The repository's Pages workflow runs the full build on GitHub.node --check docs/assets/experience.jsgit diff --check