// agents

Tell your agent. Go get coffee.

Tilemode teaches the coding agent you already use how to set up your Mac. You say what you want, it runs the commands. Your agent, your subscription. Tilemode adds zero AI costs.

01

Install the skill

Setup (or Settings › Agents) lists the coding agents it finds on your Mac. Click Install on the ones you want. It's one plain-text file. Read it, remove it, whatever.

02

Press ⌃⌥A

Pick your agent command and terminal once in Settings › Agents. After that, ⌃⌥A opens your agent in ~/.config/tilemode, already briefed.

03

Just ask

Plain English. The agent shows you the tilemode commands it's about to run, runs them, and you're done.

// say things like

Ask like you'd ask a person.

# ⌃⌥A, then:
› make issues.example.com an app on ⌥⌘L and tile it left

● using Tilemode skill
$ tilemode app add https://issues.example.com --name Issues \
    --hotkey opt+cmd+l --tile left-half
✓ Issues is in ~/Applications/Tilemode Apps
✓ ⌥⌘L → Issues
✓ Issues snaps to left-half when it opens
put my editor on ⌥⌘E
mail always opens in the right third on my second display
save this arrangement as "coding"
what hotkeys do I have?
I just got a new Mac. set everything back up from my config
// the rules

What your agent can and can't touch.

Can

  • Turn sites into apps, and remove them when you ask
  • Set and clear hotkeys for any app
  • Tile windows, add "always goes here" rules
  • Save and apply named layouts
  • Edit config.toml (Tilemode reloads on save)
  • Run tilemode doctor and tilemode license status

Can't, or won't

  • Grant Accessibility. Only you can, in System Settings
  • See what's in your windows, your keystrokes, or your screen
  • Remove anything without your OK. Removals need --yes, and the skill says to use it only when you asked
  • Ask for your license key. The skill says don't, and license status never prints it
  • Steal chords macOS already uses. Tilemode refuses them
  • Call an AI on Tilemode's dime. Tilemode makes no AI calls
// copy, paste, done

Or skip the agent.

Same commands your agent runs. Add --json for scripts.

A site on a key, tiled

$ tilemode app add https://issues.example.com --name Issues \
    --hotkey opt+cmd+l --tile left-half

A native app on a key

$ tilemode hotkey set opt+cmd+e com.example.editor
$ tilemode hotkey list

Always open there

$ tilemode rule add Mail --tile right-third --display 2

Save and restore a layout

$ tilemode layout save coding
$ tilemode layout apply coding

New Mac

$ cp config.toml ~/.config/tilemode/config.toml
$ tilemode apply

Something off?

$ tilemode doctor
$ tilemode license status --json
Tilemode didn't find your agent? Add its skill folder by hand in Settings › Agents, and install from there.

Full reference in the docs. Questions: support@tilemode.app.