Simplify quickstart and UI quickstart onboarding by soumya-io · Pull Request #30 · agentcontrol/docs-agent-control

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

soumya-io · 2026-03-14T00:34:44Z

Summary

Quickstart: docker compose is now the default path — the one-liner setup is Steps 1-2 instead of a Tip box. The clone-the-repo workflow is collapsed into an <Accordion> for contributors.
Quickstart: single-file control setup — merged the split agent-registration + control-creation scripts into a streamlined two-file flow (setup_control.py creates the control, my_agent.py runs the agent). Removes the redundant double-registration and cuts the step count from 4 to 3.
UI Quickstart: leads with "open localhost:8000" — since the docker compose setup already includes the UI, the page now opens with the dashboard URL. Manual Node/pnpm setup is collapsed into an <Accordion> for source-runners only.
UI Quickstart: removed "Regenerate API Types" — this is a contributor concern, not part of the onboarding flow.

Net result: -184 lines, fewer prerequisites to parse, and a clear copy → paste → run path.

Test plan

Verify quickstart.mdx renders correctly — Accordion expands/collapses, code blocks copy cleanly
Verify ui-quickstart.mdx renders correctly — Accordion for manual setup works
Walk through the 3-step flow end-to-end: docker compose → setup_control.py → my_agent.py
Confirm the UI dashboard loads at localhost:8000 after docker compose

🤖 Generated with Claude Code

Quickstart: - Make the docker compose one-liner the default Steps 1-2 instead of burying it in a Tip box. Collapse the clone-the-repo path into an Accordion for contributors. - Merge agent registration and control creation into a streamlined two-file flow (setup_control.py + my_agent.py) instead of three separate concepts. Remove the redundant double-registration. - Reduce from 4 steps to 3 steps. UI Quickstart: - Lead with "open localhost:8000" since docker compose users already have the UI running. Move manual Node/pnpm setup into an Accordion. - Remove the "Regenerate API Types" section (contributor concern, not onboarding). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-14T00:34:54Z

Card links check

✅ No broken Card links found. Checked external links in 0.4s

github-actions · 2026-03-14T00:35:02Z

❌ Markdown Lint Issues Found

Markdownlint found issues in the changed markdown files. Please review and fix them:

Files checked:

core/quickstart.mdx core/ui-quickstart.mdx

To fix locally:

Install markdownlint-cli2:
```
npm install -g markdownlint-cli2
```
Run on specific files:
```
markdownlint-cli2 path/to/your/file.md
```

Or run on all files:

markdownlint-cli2 "**/*.{md,mdx}" --config .markdownlint.jsonc

See the markdownlint rules documentation for details on each rule.

mintlifyBotdeployed to staging March 14, 2026 00:35 View deployment

Uh oh!

Conversation

soumya-io commented Mar 14, 2026

Summary

Test plan

Uh oh!

github-actionsBot commented Mar 14, 2026

Card links check

Uh oh!

github-actionsBot commented Mar 14, 2026

❌ Markdown Lint Issues Found

Files checked:

To fix locally:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

soumya-io commented Mar 14, 2026

Summary

Test plan

Uh oh!

github-actionsBot commented Mar 14, 2026

Card links check

Uh oh!

github-actionsBot commented Mar 14, 2026

❌ Markdown Lint Issues Found

Files checked:

To fix locally:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

soumya-io commented Mar 14, 2026

Summary

Test plan

Uh oh!

github-actionsBot commented Mar 14, 2026

Card links check

Uh oh!

github-actionsBot commented Mar 14, 2026

❌ Markdown Lint Issues Found

Files checked:

To fix locally:

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

soumya-io commented Mar 14, 2026

Summary

Test plan

Uh oh!

github-actionsBot commented Mar 14, 2026

Card links check

Uh oh!

github-actionsBot commented Mar 14, 2026

❌ Markdown Lint Issues Found

Files checked:

To fix locally:

Uh oh!