IncidentCompanionEarly development

IncidentCompanion

Untangling the intrusion is the hard part. The report shouldn’t be.

A self-hosted workspace for security incident investigation and root-cause analysis. Written for SOC, MXDR and incident-response analysts.

analyst@ir-hostoutbound · none
# Docker with Compose v2, and a shell.
$ git clone https://github.com/pureidlelabs/IncidentCompanion.git
$ cd IncidentCompanion
$ ./docker/secrets.sh
$ docker compose up --build

Just want to have a quick look? Open the demo ↗

AGPL-3.0-only, under Docker Compose, on your own hardware. No releases yet.

02 · A case

Collect it, correlate it, and the document comes out of it.

03 · How it's built

Specs first, then the code.

I write the specifications. An LLM writes most of the code from them.

20 capabilities

Each one specified

Every capability has a spec saying what it must do and a design document saying how. A change starts as a written proposal.

A constitution

Properties, not mechanisms

Short articles fixing what the system must be true of, in RFC language: “An installation with nothing configured MUST be complete, and MUST make no outbound request at all.”

31 rule tests

The rules are executable

They read the source rather than the rendered page. One fails when a screen re-implements a shared block; another when a container draws anything itself.

Read the specs →

04 · Development

Where it stands.

Today

Early development

Not ready for real casework. No releases, no upgrade path, and a case format that moves under you.

Licence

AGPL-3.0-only

Run it, read it, change it and deploy it in your own environment, for any number of analysts, at no cost.

Ahead

No release yet

The case format, the screens and the specs all keep moving until there is one. Watch the repository if you want to see it get there.