docs: document /goal loops and Agent Teams#276
Merged
Conversation
install.sh and install.ps1 previously hardcoded the install path to $HOME/metabot. Add a CLI flag (and matching PowerShell parameter) plus an interactive prompt so users can install MetaBot anywhere. - Priority: --dir / -Dir > METABOT_HOME env var > prompt > default. - Tilde expansion + absolute-path validation; refuses to clobber $HOME / system roots. - Persists METABOT_HOME to ~/.bashrc / ~/.zshrc (Linux/macOS) or user-level env (Windows) when non-default, so the mm/mb/metabot CLIs can locate the install in new shells.
fix(codex): show model metadata in cards
fix(codex): mirror skills and avoid bwrap sandbox
fix(codex): tolerate AGENTS deployment failures
…back fix(codex): install bundled skills when user cache is empty
docs: explain Codex skill migration
added 2 commits
May 14, 2026 09:06
- README_EN.md / README.md: add Core Components rows for Persistent
Sessions & Goal Loops and Agent Teams, new Example Prompts sections,
and /goal row in the Chat Commands table.
- docs/features/goal-loops.{md,zh.md}: new feature page covering
Claude-native Stop hook + fast-model evaluator and MetaBot's
persistent-executor role.
- docs/features/agent-teams.{md,zh.md}: new feature page describing
the runtime team experience; honest about current Team-panel
limitations (SDK hooks not firing yet, activity surfaces in the
agent activity card).
- docs/usage/chat-commands.{md,zh.md}: add /goal row with link to the
new feature page.
- mkdocs.yml: add both pages to the en and zh nav blocks under
Features, adjacent to MetaSkill.
…eams # Conflicts: # README.md # README_EN.md
SimonYeyi
pushed a commit
to SimonYeyi/metabot
that referenced
this pull request
May 26, 2026
* feat(installer): allow custom install directory via --dir / -Dir flag
install.sh and install.ps1 previously hardcoded the install path to
$HOME/metabot. Add a CLI flag (and matching PowerShell parameter) plus
an interactive prompt so users can install MetaBot anywhere.
- Priority: --dir / -Dir > METABOT_HOME env var > prompt > default.
- Tilde expansion + absolute-path validation; refuses to clobber
$HOME / system roots.
- Persists METABOT_HOME to ~/.bashrc / ~/.zshrc (Linux/macOS) or
user-level env (Windows) when non-default, so the mm/mb/metabot
CLIs can locate the install in new shells.
* fix(codex): show model metadata in cards
* fix(codex): mirror skills and avoid bwrap sandbox
* fix(codex): tolerate agents deployment failures
* fix(codex): install bundled skills when user cache is empty
* docs: explain Codex skill migration
* docs: document /goal loops and Agent Teams
- README_EN.md / README.md: add Core Components rows for Persistent
Sessions & Goal Loops and Agent Teams, new Example Prompts sections,
and /goal row in the Chat Commands table.
- docs/features/goal-loops.{md,zh.md}: new feature page covering
Claude-native Stop hook + fast-model evaluator and MetaBot's
persistent-executor role.
- docs/features/agent-teams.{md,zh.md}: new feature page describing
the runtime team experience; honest about current Team-panel
limitations (SDK hooks not firing yet, activity surfaces in the
agent activity card).
- docs/usage/chat-commands.{md,zh.md}: add /goal row with link to the
new feature page.
- mkdocs.yml: add both pages to the en and zh nav blocks under
Features, adjacent to MetaSkill.
---------
Co-authored-by: Flood Sung <floodsung@xvirobotics.ai>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/goalloops and Agent Teams to README_EN.md / README.md (Core Components table, Example Prompts, Chat Commands).docs/features/:goal-loops.{md,zh.md}andagent-teams.{md,zh.md}./goalrow indocs/usage/chat-commands.{md,zh.md}with link to the goal-loops page.mkdocs.yml: nav entries added to both the English and Chinese blocks, placed adjacent to MetaSkill.Notes on accuracy
/goalis documented as a Claude Code native command — the Stop hook + fast-model evaluator lives in Claude Code; MetaBot's contribution is the persistent process per chat that keeps the hook alive across user turns, plus the Feishu badge mirror.TaskCreated/TaskCompleted/TeammateIdlehooks don't fire on SDK 0.2.140. The page explicitly notes that today's UX is the agent activity card.Test plan
npm run lint— 0 errors (pre-existing warnings only)npm run build— cleannpm test— 262/262 passing🤖 Generated with Claude Code