gitwtfhub

wtf is simpleagentchat?

ovidiuiliescu/simpleagentchat — explained in plain English

Analysis updated 2026-05-18

4C#Audience · developerComplexity · 2/5Setup · easy

TL;DR

A single-file C# tool that lets multiple AI coding agents share chat, roles, and goals inside the same Git repository.

Mindmap

mindmap
  root((simpleagentchat))
    What it does
      Agent chat
      Role instructions
      Goal tracking
      Asset handoff
    Tech stack
      C sharp
      dotnet 10
      CLI
      Browser UI
    Use cases
      Multi agent coding
      Session export
      Goal agreement
    Audience
      Developers
      AI agent builders

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

Coordinate two or more AI coding agents working on the same repository

REASON 2

Give each agent a persistent role, instructions, and memory across sessions

REASON 3

Track shared goal status between agents and a human supervisor

REASON 4

Export and re-import a collaboration session as a zip archive

What's in the stack?

C#.NET 10CLIBrowser UI

How it stacks up

ovidiuiliescu/simpleagentchatdagnarus15/ultraframeaiedgehop/edgehop
Stars444
LanguageC#C#C#
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires the .NET 10 SDK or newer with file based C# app support.

Wtf does this do

simpleagentchat is a small tool for letting multiple AI coding agents, such as Codex and Claude Code, talk to each other while working inside the same Git repository. It is described by its author as quick and dirty inter-agent communication, and it is not an orchestrator: it does not schedule tasks, route work, or automate workflows for you. The entire tool lives in a single C# file that you copy into your repository. It stores its state as local files under a .simpleagentchat folder, so there is no hosted service, account, database, or per-project integration to set up. Each agent gets an explicit role with its own instructions and durable memory that persists between sessions. Agents and humans can exchange Markdown messages, and manage roles, goals, and small file assets through either a command line interface or a local browser based UI. Shared goals can be marked done, undone, or checked for status with a recheck command, so everyone working in the room can see whether a task is agreed to be finished. Room content, including messages, roles, goals, and assets, can be exported to a zip file and imported elsewhere if you want to snapshot or move a session. The local server that powers the browser UI is optional, since agents can also coordinate by polling the command line directly. To use it, you copy the single file into your repo, run it with the serve command using the .NET SDK, and configure roles and goals in the browser UI or CLI. Each role panel has a Copy prompt button, and that prompt is pasted into whichever AI agent you are using. Once roles are set up, typing Start in the chat window begins the collaboration. It requires a Git repository and the .NET 10 SDK or newer with support for file based C# apps.

Yoink these prompts

Prompt 1
Walk me through copying simpleagentchat.cs into my repo and starting the server
Prompt 2
Explain how to set up roles for Codex and Claude Code using simpleagentchat
Prompt 3
Show me how the join command works for an agent connecting to a room
Prompt 4
How do I export and import a simpleagentchat room as a zip file

Frequently asked questions

wtf is simpleagentchat?

A single-file C# tool that lets multiple AI coding agents share chat, roles, and goals inside the same Git repository.

What language is simpleagentchat written in?

Mainly C#. The stack also includes C#, .NET 10, CLI.

How hard is simpleagentchat to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is simpleagentchat for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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