Skip to content

docs: add an AI agents tab for flox agent - #129

Draft
alator-fd wants to merge 2 commits into
mainfrom
alan/agent-stacks-docs-b
Draft

alator-fd wants to merge 2 commits into
mainfrom
alan/agent-stacks-docs-b

Conversation

@alator-fd

Copy link
Copy Markdown

Adds an AI agents tab: how to run an AI coding agent (the harness), its plugins and a sandbox from a Flox environment with flox agent.

Pages (all under ai-agents/)

  • Get started: overview (harness, plugins, sandboxes), quickstart with the frontend-design plugin
  • Guides: package a skill repository, audit a plugin, launch in a sandbox
  • Command reference: flox agent list, launch, import, audit, check-plugin

Placement: a fourth top tab. The alternative was a group inside Documentation, like Imageless Kubernetes; the tab was chosen so flox.dev/ai can link to one place.

Checked

  • Every command and output sample was run against the current flox/flox-agent catalog build (0.9.0-302)
  • vale ai-agents: clean (vocabulary additions in styles/config/vocabularies/Flox/accept.txt)
  • mint broken-links: nothing new (the 3 changelog RSS links are broken on main too)
  • llms.txt regenerated

For review

  • Tab name: "AI agents" keeps the open-source "agent stacks" name out. Easy to change.
  • The pages say "agent plugins" to avoid clashing with the existing manifest "Plugins" concept page.
  • Not covered: Linux sandbox specifics (srt AppArmor on Ubuntu 24.04, nono Landlock).

… command reference

Pages for running an AI coding agent from a Flox environment with
flox agent: the harness, agent plugins and sandboxes, a quickstart
with Claude Code and the frontend-design plugin, guides for
packaging a skill repository, auditing a plugin and launching in a
sandbox, and reference pages for list, launch, import, audit and
check-plugin. Navigation is added separately.
Option B for placing the AI agent pages: a fourth top-level tab,
before Changelog, grouped as Get started, Guides and Command
reference. llms.txt regenerated from the new navigation.
@mintlify

mintlify Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
flox 🟢 Ready View Preview Oct 21, 2026, 4:25 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — e64e8630 Deployed Oct 21, 2026 by mintlify[bot]
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