Repository navigation
Releases
TiroAgents 2.1.0
What's new
- The island is now a notch. A small panel fixed to the top centre of the screen, flat against the top edge with rounded bottom corners. Closed, it shows Tiro's eyes and the time, or one line for what is next (a meeting within 15 minutes, a timer, the song) with the approvals count. Open, it is a wide panel with tabs: Home (cards you choose and order), Approvals, Agents, Calendar, Timer, Notes, Music, Trackers and Performance. Settings moved behind the gear on the tab row. See the user guide, "The island".
- Glass or Solid. Glass uses the system's real blur on Windows 11 (22H2 or later) and macOS, and a drawn glass look elsewhere; Solid is opaque. Switching recreates the notch window; your settings stay.
- Calendar from a private link. Paste your calendar's private ICS link (Outlook: publish a calendar; Google Calendar: "Secret address in iCal format"). Today's and tomorrow's events show on the Calendar tab and the Home card, with Join for Teams, Zoom, Google Meet and Webex links. Read only, refreshed every 15 minutes. The link is a secret: it is stored encrypted with the OS key storage, never logged or shown again, and sent only to its own host.
- Timers and notes. Named countdowns, a stopwatch and a Pomodoro cycle; a finished timer chimes once and shows in the closed notch. A plain list of notes. Both stay on this PC (
notch-store.json) and survive a restart. - Trackers. Plan use (5-hour session and weekly), API value of today's and the week's tokens, output tokens today, and your own daily counters. A plan gauge that cannot be read says Not available, never 0%.
- Game mode (Windows). With a borderless game in front, the closed notch shows frame rate, GPU load, GPU temperature and CPU load, and opens on Performance. An approval then shows only as a count on that line instead of opening the notch over the game. Auto, Always or Never in Settings, plus your own list of games.
- Frame rate comes from Intel's PresentMon 2.6.0 (MIT), shipped with the app and checked by its SHA-256 before every start. It needs your account in the Windows Performance Log Users group: Settings, Turn on FPS adds you after one administrator prompt, then sign out and back in. Optional; without it Performance shows load and temperature.
Fixed
- Claude sign-in. TiroAgents now finds Claude Code installed with npm (
claude.cmd) and other common install folders, so an existing sign-in is used without signing in again. The Claude panel shows the steps to install Claude Code or to sign in (withclaude auth loginto copy), a Refresh button, and updates by itself after you sign in. On Windows the sign-in window stays open until you press a key, so its link and any error stay readable.
Upgrade notes
- Settings carry over. A 2.0
kiro.jsonkeeps its theme, pinned actions, shortcut and every other island setting; the new settings (look,homeCards,gameMode,games) start at their defaults (Glass, the five default Home cards, Auto, none). - Y and N answer only the approval card you have focused, never while you type in a field.
- Not in this version: calendar sign-in, editing events, syncing notes or timers, an overlay inside exclusive-fullscreen games, and frame rate on macOS or Linux.
Meeting room with voice
- A meeting room with voice. In a party, the town has a Meeting room lot. Inside, people talk by voice: a card asks Join with microphone, Listen only or Leave. The room lists who is there (speaking, on, muted, listen only, or not joined while still on the card), M mutes and unmutes, keys 1 to 6 send a reaction and H raises your hand; others see them over your avatar for about 3 seconds. Avatars sit down on the seats, and a door and a soft chime mark someone coming in or leaving. Up to 8 people have voice; the next one sees "Voice is full". Background music pauses and party music is turned down while you are in the room, and both come back when you leave. See
docs/party.md. - Voice is direct between apps. The audio goes straight from app to app (WebRTC, encrypted); the party server only passes the short connection setup messages between people in the room and never receives the audio. Nothing is recorded. The people in the room and the public STUN servers (
stun.l.google.com,stun.cloudflare.com) can see your IP address. When a network blocks direct calls, the room says "Can't connect to …"; an optional relay server (TURN) can be set in the Party panel and stays on your PC. - Listen only never opens your microphone; press M later to talk. Coming back into the room in the same session you are muted, and the microphone is not opened until you press M.
- Reaction and hand icons use your system's emoji font, so they look different on Windows, macOS and Linux.
- Animations in the room (reactions popping and rising, the speaking bob, the door swinging, the smooth sit-down) are off under Power saver (which is on by default), reduced motion and the Low graphics preset; reactions and hands still show, without motion, and avatars sit at once.
- The entrance chime follows the music setting: with background music off or at volume 0 it is silent (and with reduced motion).
Upgrade notes (meeting room)
- Microphone and other permissions are now an explicit allow-list. The desktop app used to grant web permissions by default. It now refuses every permission except: the microphone, only for audio-only requests from the app's own page in the main window (camera is never allowed); clipboard writing for the app's own page (Copy invite link); and protected-media playback for Spotify. macOS asks for microphone access the first time you join with your microphone.
- Voice needs a 2.1 host. With a host on TiroAgents 2.0 (or a Docker party server built before 2.1), the room says "The host needs TiroAgents 2.1 for voice"; everything else in the party works as before. Rebuild the Docker party image from
party/to update it.
Installers are not code-signed: Windows SmartScreen and macOS Gatekeeper will warn. Updates are verified by the signed latest.json.
TiroAgents 2.0.0
Agent Office is now TiroAgents, named after Tiro, the manager agent. This is the first stable v2 release, for Windows, macOS and Linux; it follows the 2.0.0 beta pre-releases. The installers are still unsigned (Windows SmartScreen and macOS Gatekeeper warn); the release manifest is signed as before, so updates are verified.
Upgrade notes
- TiroAgents replaces Agent Office. The update from Agent Office 1.2.x installs TiroAgents and then removes Agent Office 1.x silently. Your settings, team, memory and reports in
~/.claude/agent-officeare kept: both apps use that folder. Start with Windows carries over. On macOS the install script removesAgent Office.app; on Linux it replaces the AppImage. - The office layout is upgraded once (see the note at the end of this section).
What's new
- Lyrics find more songs (beta.8). When the exact match misses (the player's album name or length differs from the lyrics library's copy), the island now searches by title and artist and picks synced lyrics within 3 seconds of the song's length. Songs remembered as "no lyrics" by earlier versions are looked up again.
- One settings menu with icons (beta.7). In the office and in the town, the settings (team, agents, party, music, manor, Claude, graphics, power saver, labels, preview) sit in one ☰ menu, each with its own icon; zoom, Build and Town stay at hand. The app now names its publisher in its file details.
- Get Codex, Gemini and OpenCode going without Build mode (beta.6). The Agents panel shows whether each CLI is signed in, has an Add desk button that puts its desk at a free spot in your office, and a Sign in button that opens a terminal running that CLI's own login.
- Connect your Claude (beta.6). A new Claude panel shows whether Claude Code is signed in, with which account and until when. Sign in with your Claude account or the Console, sign out, or use an API key instead: the key is typed into a small window of the app, kept encrypted on your PC and only ever shown as its last four characters.
- Settings in the town (beta.6). Buttons at the top right of the town: Tasks (what is being worked on and what is waiting), Graphics, Build, Party (join, host, members and chat), Music and Manor. Press Esc to close a panel.
- Chat bubbles (beta.6). Party chat appears as a speech bubble over whoever said it while you walk the town, and a small note pops up when Tiro writes to you.
- Music (beta.6). Background music made on your PC (calm lo-fi, a different tune in the office, the town, the karinderya and the game hall), or your own music folder. In a party, play a YouTube or Spotify link or an internet radio stream for everyone, in sync; the host decides whether anyone can pick the music. Spotify plays full songs only for people signed in to Spotify in the app (otherwise 30-second previews). Background music goes quiet while party music plays and stops while the app is hidden.
- Manor themes (beta.6). Pick a theme for your office (Modern, Country, Japanese, Beach, Cyber or Cottage) and adjust its wall, floor, roof and accent colours. Party friends see your theme on your house in the town and when they visit.
- Build mode. A Gather.town-style editor for the office: drag, add, duplicate and delete furniture, paint and resize zones, undo and redo, and start from a workspace template (Startup Loft, Agency Floor, Hotel Back-Office). Works with mouse and touch.
- External specialists. Codex CLI, Gemini CLI, OpenCode and a custom command join Tiro's team as desks you place in Build mode. Tiro delegates to them after the same hire approval (one approval, one run); they run headless with their own settings and login, read-only unless you turn on Auto mode in the desktop app, and can be stopped from their desk. A new Agents panel shows which CLIs are installed. See
docs/external-specialists.md. - Department desks. Place desks to choose Tiro's team. New roles: IT (Byte), Accounting (Ledger), Marketing (Spark), Auditor (Vera) and Notetaker (Memo), alongside the original eight. Removing a desk retires the role and keeps its memory.
- Walk the office as the CEO. Move with the keyboard, click-to-walk or an on-screen joystick. Walk up to Tiro for Chat, Prioritize, Boost (the strongest model, with a cost confirmation and plan-limit checks) or Speed (the fastest model); walk up to a desk to see what a specialist is doing.
- Graphics settings. A Graphics panel with Low, Medium, High and Ultra presets plus Custom (render scale, frame cap, ambient fps, shadows, ambient motion, lighting, renderer). Chosen automatically for your GPU; Power saver and reduced motion still win. The office honours the same settings.
- A livelier town. Soft shadows under everything, a night tint with glowing windows and lamp pools, water sparkle, swaying trees, leaves and steam. Raised terraces with cliffs and ramps you can walk up. On Low, or when the GPU is unavailable, the town draws with Canvas2D instead of WebGL.
- Memory fix. Each office visit kept another 9 MB decoded copy of the office art; it is now released with the page. Per-preset CPU, frame-time and memory budgets are checked by the perf harnesses (
docs/perf/town-step4.md). - Places to go in the town (beta.4). A tree of life, a waterfall pool, a park with benches and dog walkers, a basketball court, a cow pasture and a plaza fountain. Idle agents walk out to them and come back when work arrives; cats, dogs and cows wander. Step into a spot and a short line about the scenery appears over your player. The karinderya seats twelve, with a take-out line when it is full.
- Party world (beta.3). Host a party from the Party panel: no Docker, a share link and code with a Copy button, and you join as the host. The host's office is the main house; every guest's office stands on a friend lot, and every player sees the same town. Leaving your office brings you out at your own lot. Everyone's AI agents walk the shared town (to the game hall when idle, the karinderya at the plan limit). Party games moved into the game hall, where players see each other (also in the karinderya). When the host ends the party, everyone is told; a party that disappears is left after about a minute.
- Party in the town. Friends' offices stand on the friend lots (country, Japanese or modern style); walk to a lot's door to visit their office (view only). Everyone in the party sees each other walking the town square. Hosting:
party/host-party.ps1starts the party server in Docker and prints the share link and invite code. The app no longer leaves its server running after a crash or Task Manager, stops a leftover one on start, and asks Retry/Quit instead of opening a black window. - Online party over share links. Cloudflare quick-tunnel links do not carry live update streams, so when no update arrives within 5 seconds the app switches to long polling for the rest of the session; a lost batch triggers a full resync. IP:port hosting keeps the live stream.
- Office graphics fixes. Soft shadows sit over floor tiles, low-resolution modes keep whole pixels on any screen, night shadows and window panes are tinted correctly, and Low with ambient motion off draws no idle frames. Settings are never lost when a settings file is corrupt: the bad file is set aside and logged.
- Security hardening for release. Every write needs the session token; transcripts, notes and layouts are checked so malformed files cannot break the office; secret redaction is better; hire approvals show the full request.
Upgrade note: the office layout is upgraded once. The playroom moved to the game hall and the garden outdoors, so the first start of this build rewrites the office layout (~/.claude/agent-office/world/layout.json) without them. The original is kept beside it as layout.v1.json. To roll back, stop the app, copy layout.v1.json over layout.json, add "migrated": 2 to it if you are staying on the new build (otherwise it is upgraded again), then restart. Older builds can't read the new office.