Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Workbench Dependencies — Settings tab + askill auto-install
Status: in progress (branch feature/dependencies-settings)
Background
The Skills page wraps the open-source askill CLI. Today askill is not
installed for the user: if it is missing, SkillsPage shows a dead-end
"not installed" screen (ui/src/components/workbench/SkillsPage.tsx:291) and
the user must install it by hand.
By contrast, the Show Page runtime is a required local runtime that Vibe
Remote installs and keeps current automatically: core/show_runtime.py
(ShowRuntimeManager) plus vibe runtime prepare --strict, which is invoked
from every install/upgrade path:
- CLI upgrade →
_prepare_show_runtime_after_install(vibe/cli.py:4605/4686) - UI upgrade (no auto-restart) →
_prepare_show_runtime_after_upgrade(vibe/api.py:1647/1680) - UI upgrade (auto-restart) →
schedule_restart(prepare_show_runtime=True)→restart_supervisor
All three funnel through vibe runtime prepare (cmd_runtime, vibe/cli.py:4661).
Decision (user, 2026-05-31)
askill is a required local dependency and must be auto-installed at the same lifecycle point as the Show Page runtime — not left as a manual dead-end. Add a Settings → Dependencies tab to surface status and offer manual re-check / repair / update.
Goals
- Auto-install + keep-updated askill wherever the Show Page runtime is prepared.
- New Settings → Dependencies tab: askill, Show Page runtime, Node.js (+ a link to Backends), each with status + manual actions.
- Replace the Skills "not installed" dead-end with a one-click install.
- Reuse existing infra — no re-rolling (reuse ladder).
Non-goal (Phase 2): unify backends + askill + show runtime into one declarative "managed local tool" registry. This phase keeps askill + show-runtime explicit.
Install mechanism (verified)
Superseded: Avibe now downloads a pinned askill binary mirror-first and verifies its sha256; see
release-download-mirror.md. The original mechanism follows.
- Official one-liner:
curl -fsSL https://askill.sh | sh(same shape as the OpenCode installer already ininstall_agent). - No npm fallback: askill ships via the askill.sh installer, not a public npm
package, so a curl/bash-less host (e.g. Windows) is told to install manually
rather than hit a guaranteed-failing
npm i -g. - Target version: askill v0.1.13+.
Backend (vibe/api.py, vibe/cli.py, vibe/ui_server.py)
install_askill()— build the curl installer command (npm fallback) and run it through the existing_run_install_command(...). That helper already skips theagents.<name>.cli_pathwrite when there is noagents.askillattribute (verifiedapi.py:2327), so it is safe for a non-agent tool.ensure_askill_installed(force=False)—resolve_cli_path("askill"); if present and not forced, no-op; elseinstall_askill(). Idempotent.- Hook askill into
vibe runtime prepare(cmd_runtime): after the show runtime is prepared, callensure_askill_installed()and include askill in the status/output. Respect aVIBE_INSTALL_SKIP_ASKILLescape hatch (mirrorsVIBE_INSTALL_SKIP_SHOW_RUNTIME). This is the single chokepoint, so askill auto-installs in the same place as the show runtime — no new call sites. dependencies_status()— aggregate: askill (resolve_cli_path+askill --version), show runtime (ShowRuntimeManager.status()), Node.js (resolve_cli_path("node")+ version), backends summary (count installed via the existingget_backend_runtime). Returns{ok, deps:[{id, label, kind, required, installed, version, status, detail, action}]}.- Manual actions reuse the background install-job machinery
(
start_agent_install_job/get_agent_install_job), generalized to acceptaskill(relax theis_agent_backendgate; the worker dispatches askill →install_askill(), norestart_backend). Show-runtime repair → runvibe runtime prepare --force. - Routes (thin,
@app.route):GET /api/dependencies, and a unifiedPOST /api/dependencies/<dep>/install+GET .../install/<job_id>for both askill (install/reinstall) and show-runtime (repair, via prepare --force). - Tests (
tests/test_local_deps.py, hermetic — monkeypatch the subprocess boundary): askill install command construction,ensureidempotency, the status aggregation shape, and the job-runner generalization.
Frontend (ui/)
- Nav: add
dependenciestoSettingsPageShell.tsxTABS(after Backends, iconpackage) + theSettingsTabunion; route/admin/settings/dependenciesinApp.tsx(+ legacy/settings/dependenciesredirect). SettingsDependenciesPage.tsx— reuseSettingsPanel/SettingsRow+Badgestatus pills +Buttonactions + the install-job polling already inApiContext(generalizeinstallAgent→installDependency). Rows: askill (REQUIRED), Show Page runtime (REQUIRED), Node.js, Agent backends (dim, links to Backends). Auto-managed banner up top. Matches the design.pen framevibe-remote — Settings · Dependencies (Dark).- i18n:
settings.tabs.dependencies+settings.dependencies.*inen.json+zh.json(1:1).
Skills dead-end
SkillsPagenotInstalledblock → add a primary Install askill button (reuse the install-job + poll); on success, re-runrefresh().
Evidence layers
- Unit:
tests/test_local_deps.py. - Build/type/lint:
tsc --noEmit,vite build,ruff. - Residual manual (NOT runnable in the sandbox — AGENTS forbids mutating local
~/.vibe_remote): live install against realaskill.sh, and the auto-install hook firing during a realvibe upgrade/runtime prepare.
Todo
D1 inventory ✓ · D2 plan ✓ · D3 backend · D4 frontend · D5 skills dead-end · D6 validate + reviewer + PR + Codex watch.