Skip to content

Build agent-first website and interactive plugin quickstart - #208

Merged
Birfy merged 1 commit into
mainfrom
site/agent-first-quickstart-20261010
Oct 10, 2026
Merged

Birfy merged 1 commit into
mainfrom
site/agent-first-quickstart-20261010

Conversation

@Birfy

@Birfy Birfy commented Oct 10, 2026

Copy link
Copy Markdown
Owner

Summary

  • Rewrite the docs homepage around using AgentDescent inside Claude Code, Codex, OpenCode, and DeepSeek Harness.
  • Add an interactive in-browser agent conversation that walks through doctor, plan, approval, start, show, and apply without making model calls or changing files.
  • Turn Install into a concise plugin-first Quickstart with host-specific setup commands and copyable prompts.
  • Keep the rest of the MkDocs site and navigation intact.

Preview

Private preview: https://agentdescent-live-preview.dapper-pine-9474.chatgpt.site

Validation

  • mkdocs build --clean --strict with 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.js
  • git diff --check

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-10T04:07:01.168426Z e7f2477 PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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".

Comment thread docs/index.md
<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>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

Comment thread docs/assets/experience.js
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;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

Comment thread docs/assets/experience.js
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.');

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

@Birfy
Birfy merged commit 31b2e0c into main Oct 10, 2026
2 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant