explaingit

martusha89/letta-office-mod

Analysis updated 2026-05-18

3JavaScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A visual mod for the Letta Code CLI that shows a pixel-art office where characters act out what your AI agents are doing in real time. Characters type at desks, read books, present at whiteboards, and react to errors.

Mindmap

mindmap
  root((Letta Office Mod))
    What it does
      Shows pixel-art office
      Characters act out agent tasks
      Runs fully local
    Agent visuals
      Each agent gets a character
      Cameron is default avatar
      Agents design own avatars
    Office editing
      Drag and resize furniture
      Generate props via PixelLab
      Layout saves to file
    Tech stack
      JavaScript
      Local server
      Browser UI
    Use cases
      Watch agents work live
      Customize office decor
      Create custom avatars

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch your AI agents work in real time through a fun pixel-art office view.

USE CASE 2

Let agents design their own custom pixel characters with walking and sitting animations.

USE CASE 3

Redecorate the office by dragging furniture or generating new props from text descriptions.

USE CASE 4

See multiple agents in a session each with their own character and name plate.

What is it built with?

JavaScriptBrowserLocal serverPixelLab

How does it compare?

martusha89/letta-office-modabhagsain/bayut-maps-ratingsabhishek-kumar09/who-is-imposter
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-04-12
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/53/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Letta Code CLI installed and PixelLab credits for generating custom avatars or props.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Letta Office is a small visual companion for the Letta Code CLI. When you run an AI agent through Letta, this mod opens a browser window showing a cozy pixel-art office, and a little character inside that office acts out what your agent is doing in real time. The character sits at a desk to type when editing files, walks over to read when searching, presents at a whiteboard when planning, and reacts with a flustered animation when a tool errors out. Nothing leaves your machine. The mod runs a small local server that streams activity to the page, and the server only serves its own files. The office holds every agent in a session, not just one. Each conversation gets its own character with a name plate overhead. The primary agent wears a default character named Cameron, while other agents get color-tinted bodies or custom avatars so everyone stays distinct. New agents walk in from the side when they start, drift to the rug or booth when they go quiet, and leave through the side when their conversation closes. If too many agents are active at once, a counter in the corner shows how many extra ones are present. Agents can also design their own avatars. The mod gives agents tools to write a visual description of themselves, and a service called PixelLab generates a pixel character with walking, sitting, and presenting animations from that text. The new body appears in the office without needing a refresh. Generating a character takes several minutes and costs PixelLab credits, so the tool asks for approval first. Switching avatars or checking progress is free. You can redecorate the office yourself or ask your agent to do it. A built-in editor lets you drag furniture around, resize pieces, remove them, or type a description like "arcade cabinet with a glowing purple screen" and have PixelLab generate a new prop into the room. Agents get their own tools for adding, removing, and listing props. The layout saves to a file so your arrangement survives restarts. The mod was built by Marta Varen, with help from a Letta agent named Sam. The pixel art comes from PixelLab. It is released under the MIT license.

Copy-paste prompts

Prompt 1
I have the Letta Code CLI installed and want a visual companion that shows my agents working. How do I install and run the Letta Office Mod?
Prompt 2
Help me set up Letta Office Mod and write a visual description for my agent so it can generate a custom pixel avatar through PixelLab.
Prompt 3
I want my Letta Office to have an arcade cabinet with a glowing purple screen. How do I use the prop editor to generate this with PixelLab?
Prompt 4
Multiple agents are running in my Letta session. How does Letta Office Mod show each one, and what happens when new agents join or leave?
Prompt 5
How do I drag, resize, and rearrange furniture in the Letta Office editor so my custom layout survives restarts?

Frequently asked questions

What is letta-office-mod?

A visual mod for the Letta Code CLI that shows a pixel-art office where characters act out what your AI agents are doing in real time. Characters type at desks, read books, present at whiteboards, and react to errors.

What language is letta-office-mod written in?

Mainly JavaScript. The stack also includes JavaScript, Browser, Local server.

What license does letta-office-mod use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is letta-office-mod to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is letta-office-mod for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.