Skip to content

docs(update): document project ak update refreshing every installed runtime - #250

Merged
mrgoonie merged 1 commit into
devfrom
docs/ak-update-project-runtimes
Oct 8, 2026
Merged

mrgoonie merged 1 commit into
devfrom
docs/ak-update-project-runtimes

Conversation

@mrgoonie

@mrgoonie mrgoonie commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Beta docs for project ak update refreshing every installed runtime.

  • reference/cli/update (EN + VI): new "Project runtime refresh" section; project --target a,b now filters installed runtimes (no longer "exactly one"); skipped_targets; runtime-only projects refresh instead of exit 2; preview/--dry-run rows; CLI preflight takes the highest requirement; plugin-only, source_inapplicable, and project_is_global_home rows; background auto-update records a notice instead of refreshing runtimes; project --force never archives legacy Codex skills (needs_legacy_migration row, ak migrate --from ck); exit 1/2 rows updated; new example; JSON kits/skipped_targets on project output.
  • guides/updating (EN + VI): short project-runtime paragraph, background notice, and corrected project target wording.

No Stable or generated files touched.

Source evidence

  • bestagentkits/agentkit origin/dev commit 766318dcee6feb6188f6d169b0aa2032c36c1110 (PR #2188, closes #2182). The home-directory skip from 6e5874b4de7e58e955713d64cc5df4d7b91e81c8 is squashed into it.
  • Checked against apps/cli/internal/commands/updatecmd/{project_runtime_refresh,update,unified,global_update}.go, autoupdatecmd/runner.go, and docs/system-architecture.md.
  • Not in v3.0.0-beta.8.

Validation

pnpm lint, pnpm typecheck, pnpm check:prose, pnpm check:reference, pnpm build, pnpm check:links, pnpm check:seo pass locally (Windows). pnpm test, check:quality, check:assets have known Windows path failures on untouched dev, so Linux CI covers them.

Hold: merge only after an AgentKit beta release contains 766318dce (bestagentkits/agentkit#2188).

Refs #249

🤖 Generated with Claude Code

…untime

Describe the attended project update that refreshes the kits/ tree and
then each installed runtime of each project kit: --target filtering at
project scope, skipped_targets, runtime-only projects, preview rows, the
home-directory skip, background auto-update notice, project --force and
legacy Codex archival, and the new exit 1/2 cases.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mrgoonie
mrgoonie merged commit a7c027f into dev Oct 8, 2026
2 checks passed
@mrgoonie

mrgoonie commented Oct 8, 2026

Copy link
Copy Markdown
Contributor Author

Superseded by #253

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