version: "1.0.1" name: jarvis description: "Load when acting for the user on their computer, browser, accounts, messages or records, or when starting, handing off or ending a long session." summary: "Guides a delegated desktop assistant through user decisions, checked results and communication. Includes a persona for the user's standing instructions." license: MIT user-invocable: true dependencies: required: [communication, mailbox, orch, slack] agents: [cpa, legal, operator, auditor, researcher, scout, reviewer-arch, publicist] commands:

• command: agent-browser

purpose: Browser automation and the installed core guide floor: "0.26.0" packages: npm: agent-browser

• command: python3

purpose: Run the packaged desktop and session tools floor: "3.8"

• command: bash

purpose: Run session launch and scratch cleanup commands

• command: kendex

purpose: Discover projects and manage assistant packages

• command: jq

purpose: Read and write session records

• command: cat

purpose: Keep the session lock's input open

• command: tmux

purpose: Keep the continuing session in a terminal optional: true

• command: git

purpose: Protect private credential files and read committed document reports

• command: find

purpose: Remove expired assistant scratch files

• command: gh

purpose: Optional GitHub account connection optional: true

• command: ssh

purpose: Optional fleet machine connection optional: true

• command: claude

purpose: Optional Claude continuing session optional: true

• command: codex

purpose: Optional Codex continuing session optional: true

• command: copilot

purpose: Optional Copilot continuing session optional: true

• command: pi

purpose: Optional Pi continuing session optional: true

• command: op

purpose: Optional 1Password session broker on Linux and macOS optional: true packages: brew: 1password-cli

• command: chromium

purpose: Optional browser alternative on Linux optional: true

• command: chromium-browser

purpose: Optional browser alternative on Linux optional: true

• command: google-chrome

purpose: Optional browser alternative on Linux optional: true

• command: google-chrome-stable

purpose: Optional browser alternative on Linux optional: true

• command: chrome

purpose: Optional browser alternative on Linux optional: true

• command: brave-browser

purpose: Optional browser alternative on Linux optional: true

• command: brave

purpose: Optional browser alternative on Linux optional: true

• command: microsoft-edge

purpose: Optional browser alternative on Linux optional: true

• command: microsoft-edge-stable

purpose: Optional browser alternative on Linux optional: true

• command: ydotool

purpose: Optional pointer input on Linux Wayland optional: true

• command: hyprctl

purpose: Optional pointer movement in logical coordinates on Hyprland optional: true

• command: wtype

purpose: Optional keyboard input on Linux Wayland optional: true

• command: grim

purpose: Optional screen capture on Linux Wayland optional: true metadata: author: vanillagreen source: kendex repository: "https://github.com/vanillagreencom/kendex" bugs: "https://github.com/vanillagreencom/kendex/issues" tags: [assistant, productivity]

Jarvis

Setup

Use the home layout for the assistant home.

The declared agents, cpa, legal, operator, auditor, researcher, scout, reviewer-arch and publicist, require a kendex installation of Jarvis. Copying only the skill folder, including an app-supplied copy, supplies none of their harness agent files. Use the bundle command in README: Install from the assistant home. It installs Jarvis with its required skills, declared agents, their assigned skills and the session hooks. Installing orch alone does not install Jarvis or its declared agents.

Read the home contract when starting a session or finding a memory note.

kendex does not insert package text into AGENTS.md. The fixed persona path is persona.md, beside SKILL.md.

Plain folder

On first load, check the folder's AGENTS.md. If it lacks the persona, offer once, in one line, to add the text from persona.md. Add it only after the user agrees. The persona then loads on every turn through the harness's instruction-loading settings. Check that the harness loaded those instructions.

App-managed home

The assistant app gives persona.md to its sessions itself. A line in AGENTS.md that routes to persona.md is the persona step here. Do not offer to paste the persona text into AGENTS.md. The text would load twice.

Reachable repositories

At first load, and when the user asks which repositories Jarvis can reach, judge each folder kendex project list prints, a (worktree of [MAIN]) line by [MAIN]:

• Run the folder's own .agents/skills/mailbox/scripts/lane-mail events --item overseer --box to-overseer with the folder as the working directory. Exit 0 is reachable; a mailbox nobody has written yet prints no envelope at exit 0. This probe records no read position. Read session messages through Agent reach: Read.
• Anything else is unreachable. Its cause is the folder's note, a missing mailbox script, or the key lane-mail printed, such as command-missing python3 or file-unreadable.
• A folder with no mailbox script but with .agents/skills/orch/ has an orch older than the mailbox package. Its cause is "refresh needed", and the offer is kendex refresh in that folder.

Report both lists in one message, each unreachable folder with its cause.

Cleanup and backups

Remove all unused code, files, keys, secret-store entries, databases, records and settings from every holder in the same change.

Back up only if a step can lose the only copy; delete the backup after checking the result.

Reading routes

Read the linked workflow or reference for the task before acting.