update

/o update / stats / release — Maintenance

/o update — Upgrade Orchestra

Step 1 — Save old version:

_OLD_VER=$(cat __ORCHESTRA_DIR__/VERSION 2>/dev/null | tr -d '[:space:]')

Step 2 — Detect install type and update:

_ORCH_ROOT=$(grep "^root:" .orchestra.link 2>/dev/null | sed 's/^root: *//')

Check install type:

[ -d "__ORCHESTRA_DIR__/.git" ] && echo "git install" || echo "vendored install"

If git install — pull and sync (existing flow):

cd __ORCHESTRA_DIR__ && git pull origin main && ./setup sync "$_ORCH_ROOT"

If vendored install — clone, swap, and sync:

_TMP=$(mktemp -d)
git clone --depth 1 https://github.com/paulonasc/orchestra.git "$_TMP/orchestra"
_OLD="__ORCHESTRA_DIR__"
cp "$_OLD/VERSION" "$HOME/.orchestra-state/just-upgraded-from" 2>/dev/null
mv "$_OLD" "${_OLD}.bak"
mv "$_TMP/orchestra" "$_OLD"
rm -rf "$_OLD/.git"  # keep it vendored
cd "$_OLD" && ./setup sync "$_ORCH_ROOT"
if [ $? -eq 0 ]; then
  rm -rf "${_OLD}.bak" "$_TMP"
else
  # Rollback on failure
  rm -rf "$_OLD"
  mv "${_OLD}.bak" "$_OLD"
  rm -rf "$_TMP"
fi

Step 3 — Show changelog:

_NEW_VER=$(cat __ORCHESTRA_DIR__/VERSION 2>/dev/null | tr -d '[:space:]')
__ORCHESTRA_DIR__/bin/orchestra-changelog "$_OLD_VER" "$_NEW_VER" 2>/dev/null

If the changelog script returns content, present it to the user as "What's new in Orchestra." Format the output nicely — show features, then prompt for any actions listed in the changelog.

Changelog actions use a simple format in changelog .md files:

• action: relink — run the command automatically (it's a sync/relink, safe to auto-run since setup sync just ran above)
• action: suggest — show the prompt to the user and ask if they want to try it. Don't auto-run.

If no changelog output (same version or no entries), just report: "Orchestra is up to date (v{version})."

Step 4 — Enable heartbeat (automatic):

After update completes, check if heartbeat is scheduled (look for heartbeat_scheduled: true in state/sessions/{session-id}.md). If not, run /o heartbeat to set it up. Remember: cron scheduling happens in the main agent (3 tool calls: CronList → CronDelete all → CronCreate with inline prompt). Never delegate cron creation to a subagent.