Skip to content

docs: update getting-started to reflect brew install + CLI workflow#49

Merged
codejunkie99 merged 2 commits intocodejunkie99:masterfrom
kagura-agent:docs/update-getting-started
May 9, 2026
Merged

docs: update getting-started to reflect brew install + CLI workflow#49
codejunkie99 merged 2 commits intocodejunkie99:masterfrom
kagura-agent:docs/update-getting-started

Conversation

@kagura-agent
Copy link
Copy Markdown
Contributor

Summary

The docs/getting-started.md guide still referenced the pre-v0.9 workflow (git clone + cp -R .agent/ + ./install.sh), while the README quickstart now uses brew install agentic-stack and the agentic-stack <harness> CLI.

Changes

  • Lead with Homebrew as the recommended install path (matching README)
  • Use agentic-stack CLI commands instead of ./install.sh throughout
  • Add "Managing your project" section covering dashboard, doctor, upgrade, sync-manifest, add/remove/manage subcommands
  • Add "Keeping up to date" section with brew upgrade + safe project upgrade flow
  • Note onboarding wizard pre-populates PREFERENCES.md
  • Keep clone-based install as an alternative for non-Homebrew users
  • Keep Windows PowerShell instructions unchanged

Why

New users following the getting-started guide would encounter stale instructions that don't match the current CLI experience. This aligns the guide with the v0.16.0 README quickstart.

kagura-agent and others added 2 commits May 9, 2026 19:28
The getting-started guide still referenced the old git-clone + cp -R
workflow and ./install.sh directly. Update it to match the current
README quickstart:

- Lead with brew tap/install as the recommended path
- Use 'agentic-stack <harness>' CLI commands instead of ./install.sh
- Add 'Managing your project' section with dashboard, doctor, upgrade,
  sync-manifest, add/remove subcommands
- Add 'Keeping up to date' section covering brew upgrade + safe
  project upgrade flow
- Note that onboarding wizard pre-populates PREFERENCES.md
- Keep clone-based install as an alternative for non-Homebrew users
- Keep Windows PowerShell instructions unchanged
@codejunkie99 codejunkie99 merged commit 106db3a into codejunkie99:master May 9, 2026
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.

2 participants