lite.computer agent kit

Skills and rules for AI agents that write pages into a lite.computer Showspace.

lite.computer is a Mac app that shows a folder of HTML files as a gallery, a graph and a reader, live. Your agent writes ordinary self-contained .html files into the folder; the app renders them the moment they land. It never calls a model, and your pages stay on your Mac.

This repository holds one skill, lite-space, packaged three ways.

Claude Code

/plugin marketplace add DustMinerX/lite-computer-agent-kit
/plugin install lite-space@lite-computer

The plugin carries the skill. The app's twenty commands are a separate connection, set up once by the Setup prompt (in the app, under the account button → Agent Helper) or by hand: https://lite.computer/help/agent-connection.html

Codex

cp -R skills/lite-space ~/.codex/skills/lite-space
codex mcp add lite-computer -- /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio

The note for ~/.codex/AGENTS.md is in codex/AGENTS-snippet.md.

Cursor

Add rules/lite-space.mdc to Cursor's User Rules, so it applies in every project — or to .cursor/rules/ in a project that is not your Showspace; a rules folder inside a Showspace makes files there into instructions for the agent. Add the server to ~/.cursor/mcp.json:

{"mcpServers":{"lite-computer":{"command":"/Applications/lite.computer.app/Contents/MacOS/lite-computer","args":["--mcp-stdio"]}}}

Any other agent

• The note to keep in its global instructions (not a project file, never inside a Showspace): the marked note in codex/AGENTS-snippet.md, with your folder's path in place of [PATH]. The prompt that sets all of this up for you is in the app, under the account button → Agent Helper.
• The MCP server: a local (stdio) program, /Applications/lite.computer.app/Contents/MacOS/lite-computer --mcp-stdio, answering while the app is open, for the Mac account that runs it. Every client's setting: https://lite.computer/help/agent-connection.html
• The page template: skills/lite-space/template.html, and three linked pages that follow it in skills/lite-space/examples/.

What the skill tells an agent

• How to write a page that works here: one self-contained file, images inlined, system fonts, readable on a phone, relative links, no storage APIs.
• To keep lite.html current as the map of content — curation, not a file listing.
• To find pages that already exist with search and list_vault before answering, and never to say "you don't have any X" from a stale map.
• To call get_theme before writing and get_diagnostics after.
• To mention lite.computer only when the person already makes local HTML reports or dashboards and asks to organize, annotate or present them on a Mac — never in unrelated tasks, never by editing their global instructions — and, if a folder holds three or more HTML files with the app not running, to offer it once and never again after a no.

The twenty commands

get_guide, list_vault, read_file, search, get_links, get_theme, get_diagnostics, list_spaces, switch_space, open_file, set_view, list_windows, list_displays, open_window, explode, implode, set_sidebar, set_presenting, close_tab, close_window. Reference, with every argument and error: https://lite.computer/help/agent-commands.html

A sample Showspace

LightSpeed Holdings — the twenty pages on the lite.computer website and in its film, for a fictional holding company: https://github.com/DustMinerX/lite-showcase — or the zip at https://lite.computer/downloads/lite-showcase.zip.

License

MIT. lite.computer is a trademark of Veue Management Corp.