theCity — Transforming projects into a city of robot…

Pitch

Description

Comments

About this project

The City is a native macOS application that visualizes Claude Code as a bustling city, where projects become buildings and teams are structured across floors. By integrating with the claude CLI, it seamlessly runs code while providing an engaging and interactive interface for managing tasks. Experience a new way to organize and animate coding workflows.

theCity is a macOS application designed to visualize Claude Code as a vibrant city of robot-staffed offices. In this innovative setup, each project folder transforms into a building, with every building featuring several floors that represent teams of robots. Every animation in the application reflects actual events from the Claude CLI's activity stream, providing an engaging and interactive experience while working on projects.

The application seamlessly initiates runs of Claude Code using the installed version of claude, ensuring that all interactions count towards the user's plan. It is important to note that only sessions initiated through the application are displayed.

Key Features

Project Organization: Each project folder is regarded as a building, and developers are able to monitor the status of projects through beacon indicators, which signify whether a building is active or requires attention.
Receptionist Functionality: The app employs a receptionist feature that intelligently routes user requests to the most suitable team on the appropriate floor, considering existing workloads.
Team Management: New floors can be created by selecting departments from the project's .claude/agents/*.md file, allowing flexible team configurations.
Parallel Workflows: Multiple floors are capable of running in parallel, optimizing productivity and resource usage.
Integrated CLI Events: The application incorporates a real-time CLI event system, where robots manage tasks at their designated desks, streamlining project workflows.
Office Overview: Users can easily navigate through different offices and floors, overseeing ongoing tasks, approvals, and deliveries.

Requirements

macOS Version: Requires macOS version 26 or later.
Claude Code: Must have Claude Code version 2.1.163 or later installed and signed in; older versions compromise security and functionality.
Apple Intelligence: The app utilizes on-device intelligence to enhance work routing and team management.

Settings and Notifications

Users can customize settings for new jobs, including account preferences, budget constraints, and notifications. When the app runs in the background, it actively notifies users of pertinent events via the Dock icon.

Contribution Opportunities

An active backlog is maintained on GitHub Issues, providing transparency on ongoing projects and encouraging contributions from the community. Users can explore and report bugs or suggest ideas directly through the platform.

Building from Source

For developers interested in contributing or customizing the application, instructions for building from source are provided. Dependencies such as Xcode and XcodeGen are required.

Overall, theCity revolutionizes project management by bringing the Claude Code environment into a visually compelling and organized format, making coding tasks engaging and efficient.