gitwtfhub

wtf is damon-ade?

per-simmons/damon-ade — explained in plain English

Analysis updated 2026-05-18

89TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A macOS desktop app that organizes multiple persistent AI coding agents, each with its own repo, terminal sessions, and long-term memory.

Mindmap

mindmap
  root((repo))
    What it does
      Manages coding agents
      Persistent memory
      Multi model sessions
    Tech stack
      TypeScript
      Electron
      Bun
    Use cases
      Multi agent workflows
      Cross model switching
      Long term project memory
    Audience
      Developers
      AI power users

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

Why would anyone build with this?

REASON 1

Manage several AI coding agents, each working on a different repo, from one app

REASON 2

Keep a coding agent's memory and context persistent across days of work

REASON 3

Switch a single agent between Claude Code, Codex, and OpenCode without losing its memory

REASON 4

Run open models like Kimi or GLM through OpenRouter alongside Claude and Codex

What's in the stack?

TypeScriptElectronBun

How it stacks up

per-simmons/damon-adefayazara/pdfstudioilliahaidar/mcptrustchecker
Stars898989
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires macOS, Git, and at least one coding CLI such as Claude Code already installed.

Wtf does this do

ADE is a desktop app for macOS that helps you organize and work with multiple AI coding assistants at once. Instead of a single throwaway chat, each assistant in ADE is set up as a persistent agent with its own name, photo, git repository, and memory that carries over from one day to the next. The app is organized as a two level sidebar. Teams sit at the top level and group related work together, and inside each team you create individual agents. Clicking on an agent opens its workspace, which shows a row of terminal sessions running that agent's coding tool inside its own copy of the code, plus a panel on the side that displays the agent's growing memory files. ADE does not include any AI coding tools itself. Instead it runs coding command line tools you already have installed, such as Claude Code, OpenAI's Codex, or OpenCode. A model bar also lets you start a session using other models, including Kimi, MiniMax, and GLM, by connecting your own OpenRouter account with an API key you enter once inside the app. Everything, including your code and that key, stays on your own computer rather than being sent to a hosted service. Each agent keeps its memory as a small set of plain text files: one describing its identity and role, one describing you and your preferences, one holding notes and lessons it has picked up, and optional reusable skill files it writes for itself. These files live outside the actual code repository so they are not affected by switching branches, and the agent is expected to update them at the end of each session so the next session starts with more context. To install ADE you either download a signed installer from the releases page or build it yourself from source using Bun, which requires Git and at least one supported coding tool such as Claude Code to already be installed. The project describes itself as a modified version of an existing project called Superset.

Yoink these prompts

Prompt 1
Walk me through installing ADE and creating my first team and agent
Prompt 2
Explain how ADE's agent memory files work and when an agent updates them
Prompt 3
Show me how to connect an OpenRouter API key to use GLM or Kimi in ADE
Prompt 4
Help me build ADE from source using Bun

Frequently asked questions

wtf is damon-ade?

A macOS desktop app that organizes multiple persistent AI coding agents, each with its own repo, terminal sessions, and long-term memory.

What language is damon-ade written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, Bun.

How hard is damon-ade to set up?

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

Who is damon-ade for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.