Tiles
Download
Skip to Content
Manual

Manual

Command Line Options

Commands are grouped by subcommand family: the base tiles command, identity, data layout, models, updates, ATProto linking for sharing, then peer-to-peer linking and sync.

Main command (tiles)

Launches onboarding (first run) and the interactive REPL.

tiles   # Onboarding (if needed) and REPL

Account (tiles account)

Root identity and display nickname.

tiles account create [<nickname>]  # Create root identity (nickname optional)
tiles account set-nickname         # Set nickname
tiles account                      # Show account details
tiles account create alice
tiles account set-nickname
tiles account

Data folder (tiles data)

Where Tiles stores local data files.

tiles data set-path <path>   # Set data folder
tiles data set-path ~/.tiles/data

Run models (tiles run)

Start a chat session with a model; optional Modelfile path.

tiles run [MODELFILE_PATH]   # Default model if path omitted
tiles run
tiles run ./path/to/Modelfile

App updates (tiles update)

tiles update   # Check for and install app updates

Tiles can sync chats across multiple linked devices peer-to-peer, with or without the internet. Linking is a one-time step so both sides consent before any sync traffic is accepted; you do not need to re-link each time you sync.

tiles link enable      # Become link listener; share the ticket out of band
tiles link list-peers  # Show linked peers (DID and nickname)
tiles link disable     # Unlink a peer; ignore their future sync requests

tiles link enable: Puts this device in link listener mode. It generates a link ticket and waits for a link request from another device. Share the ticket out of band with the peer you want to link.

  • If the device is online, the ticket is a base64 string (easy to copy).
  • If offline, the ticket is an eight-character alphanumeric code you can type on another device on the same network.

When the peer runs tiles link enable and supplies your ticket, this device is notified; after you approve, the two devices are linked.

tiles link list-peers: Lists linked peers by DID (decentralized identifier) and nickname.

tiles link disable: Unlinks a peer. Future sync requests from that peer are ignored.

Peer-to-peer: chat sync (tiles sync)

After devices are linked, use tiles sync to replicate chats. Listener and initiator roles mirror linking: one side waits, the other connects using the listener’s DID.

tiles sync        # Listener: wait for incoming sync requests
tiles sync <DID>  # Initiator: sync toward the peer with this DID (the listener)
 
# Example
tiles sync did:key:z6Mknxy...YWSmTcZA

tiles sync (listener): Starts this device in sync listener mode: it waits for incoming sync requests.

On the other device, run tiles sync with the listener’s DID so the initiator targets the correct peer. If your CLI uses different syntax for the peer argument, check tiles sync --help.

When a sync run finishes, you should get a notification on the devices involved.

ATProto (tiles at)

ATProto is currently used to share chat sessions.

  • tiles at login <handle>: log in with your ATProto handle (for example, alice.bsky.social) via browser OAuth.
  • tiles at logout: log out of the current ATProto account.
tiles at login alice.bsky.social
tiles at logout

Authentication currently uses a localhost callback (127.0.0.1:8988), and session state is stored locally in the Tiles database.

Slash commands

Slash commands give you fast, keyboard-first control over Tiles in interactive chat. Type /? or /help in the prompt to open available commands and quickly run actions like checking session state, resuming prior sessions, and sharing chats without leaving the terminal. Use /bye to exit the chat session.

Session Commands

  • /status
    Show the current session state.

  • /sessions
    List available sessions in local storage.

  • /resume <sessionId>
    Resume a specific session by ID.

Sharing Commands

These commands require an active ATProto login. See #ATProto (tiles at).

  • /share (via ATProto)
    Create a shareable link for the current session.

  • /share <sessionId> (via ATProto)
    Create a shareable link for a specific session.

Example shared session link: tiles.run/share/YXQ6Ly9k…xeTI3.

Uninstall Tiles (macOS)

The full macOS uninstall procedure now lives in a dedicated skill file that includes stop steps, installed-path cleanup, data-path cleanup, optional receipt and keychain cleanup, and warnings for destructive commands.

We are actively working on an official Tiles uninstaller.

To use it with coding agents (for example Claude Code or Codex), share the skill file URL in your prompt and ask the agent to follow it step by step while adapting only paths that differ on your machine.

Read and download it here: https://tiles.run/tiles-uninstaller-skill/SKILL.md.