openagent-canvas-bootstrap

name	openagent-canvas-bootstrap
description	Bootstrap or update OpenAgent for Codex plus Obsidian Canvas. Use when the user wants a one-step setup for the current repo, or wants to update the installed OpenAgent skill and local OpenAgent checkout on their machine.

OpenAgent Canvas Bootstrap

Use this skill when the user wants the fastest path from "I have Codex and Obsidian" to "this repo is already wired into an Obsidian Canvas workspace and the local mobile dashboard is already open", or when they want to update the installed OpenAgent skill/runtime.

What this skill does

For setup, run:

bash "$CODEX_HOME/skills/openagent-canvas-bootstrap/scripts/bootstrap-openagent-current-repo.sh"

The script uses the current working directory as the target repo unless OPENAGENT_TARGET_REPO is set. By default it reuses the Obsidian vault the user currently has open. It also starts the local Convos dashboard for the same repo and opens http://127.0.0.1:4321 automatically.

For updates, run:

bash "$CODEX_HOME/skills/openagent-canvas-bootstrap/scripts/update-openagent-install.sh"

Defaults

• Installs or reuses the OpenAgent source at ~/.openagent/source/openagent
• Reuses the currently open Obsidian vault when one is available
• Opens Obsidian after bootstrap
• Starts the daemon unless the caller passes --skip-daemon-start
• Starts convos-control for the target repo and opens the local dashboard unless the caller passes --skip-convos-start or --no-open-dashboard
• Uses XMTP_ENV=production by default for the mobile dashboard when XMTP_ENV is not already set

Useful overrides

• OPENAGENT_TARGET_REPO: bootstrap a repo other than the current working directory
• OPENAGENT_INSTALL_DIR: change where the OpenAgent source is cloned
• OPENAGENT_VAULT_PATH: force a specific existing Obsidian vault path
• OPENAGENT_VAULT_ROOT: create a dedicated vault under this folder instead of reusing the open vault
• OPENAGENT_VAULT_NAME: override the dedicated vault name when using OPENAGENT_VAULT_ROOT
• OPENAGENT_WORKSPACE_NAME: override the generated workspace name
• OPENAGENT_UPDATE=1: pull the latest OpenAgent changes before bootstrapping
• OPENAGENT_SKIP_CONVOS_START=1: bootstrap Obsidian and the daemon without starting the mobile dashboard
• OPENAGENT_NO_OPEN_DASHBOARD=1: start the mobile dashboard but do not auto-open the browser

Workflow

1. If the user asks to update OpenAgent or this skill, run the update script and tell them to restart Codex after it finishes.
2. Otherwise, confirm the user is on macOS and already has Obsidian Desktop plus Codex installed.
3. Run the bootstrap script from the current project.
4. If the script succeeds, tell the user the vault path, that Obsidian should open, and that the local mobile dashboard should open at http://127.0.0.1:4321.
5. Remind them they can start from the generated Main.canvas in Obsidian, or press New Thread in the dashboard to create a QR chat for their phone.
6. If Obsidian did not focus the canvas automatically, tell the user to open Workspaces/<repo-slug>/Main.canvas inside their current vault.

Notes

• Prefer the script over manually restating the shell steps.
• The script is idempotent: rerunning it should reuse the same OpenAgent checkout, vault, plugin wiring, and workspace when possible.