Skip to content

// GET STARTED

install

ulk is a collection of Markdown agents for Claude Code. No runtime, no dependencies — just a folder of files copied into ~/.claude/.

MIT v4.1.0 macOS · Linux · WSL
1. CLONE

Grab the repo anywhere on your machine.

BASH
git clone https://github.com/izo/ulk
cd ulk
2. INSTALL

The installer compiles agents into the shapes Claude Code expects and copies them into your user config.

BASH
./install.sh

Figma (7), Swift (7) and Flutter (2) community skills are included by default.

Optional flags:

BASH
./install.sh --with-figma-mcp       # configure Figma MCP server
./install.sh --with-vps             # + VPS agents
./install.sh --with-teams           # + Agent Teams (experimental)
./install.sh --with-addy-skills     # + addyosmani community skills
./install.sh --with-a11y-skills     # + accessibility skills (RAWeb/RAAM)
./install.sh --with-obsidian-skills # + Obsidian skills (kepano)
./install.sh --with-nothing-design  # + Nothing design system (dominikmartn)
./install.sh --with-memory-loop     # + Obsidian memory loop hooks
./install.sh --dry-run              # simulate without writing

macOS 26+ bonus: install Apfel to offload micro-tasks (extraction, classification, summaries) to Apple Intelligence — free, local, zero Claude tokens.

BASH
brew install Arthur-Ficial/tap/apfel
3. VERIFY

Confirm the agents are wired up and the CLI helpers can be found.

BASH
./install.sh --verify
./tools/check-tools.sh
4. INVOKE BRUCE

From inside any project, open Claude Code and run the orchestrator. Bruce auto-detects project state and routes to the right agent.

TEXT
/ulk:bruce

# or simply type
bruce
UPDATE

ulk releases are pulled by re-running the installer.

BASH
cd /path/to/ulk
git pull
./install.sh
UNINSTALL

Removes installed agents from ~/.claude/.

BASH
./uninstall.sh
NEXT

Learn how agents are organized in /agents, or dig into the /docs tree for architecture and protocols.