git404hub

what is agent-chief fr?

smilelikeye/agent-chief — explained in plain English

Analysis updated 2026-05-18

1,003PythonAudience · developerComplexity · 3/5LicenseSetup · easy

tl;dr

A local first tool that filters every AI agent alert and feed through a judgment engine, deciding whether to interrupt you, dispatch work, or file it for later.

vibe map

mindmap
  root((agent chief))
    What it does
      Filter alerts
      Decide interrupt
      Dispatch to agents
    Tech stack
      Python
      SQLite
      DeepSeek
    Use cases
      Reduce alert noise
      Verify agent work
      Learn preferences
    Audience
      Developers
      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

what do people make with this?

VIBE 1

Filter noisy AI agent and monitoring alerts so only the ones worth attention reach you.

VIBE 2

Automatically dispatch routine tasks to your agents and verify they were actually completed.

VIBE 3

Learn your personal interruption preferences over time from simple thumbs up or down feedback.

VIBE 4

Run a fully offline demo to see how the three stage decision engine handles a day of events.

what's the stack?

PythonSQLiteDeepSeek

how it stacks up fr

smilelikeye/agent-chiefjmerelnyc/talosspecterops/nemesis
Stars1,003987986
LanguagePythonPythonPython
Last pushed2026-07-11
MaintenanceActive
Setup difficultyeasymoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperops devops

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

how do i run it?

Difficulty · easy time til it works · 5min

The demo runs offline with zero keys, connecting real agents and sources needs a short setup wizard.

in plain english

Chief is a tool that sits between a person and everything competing for their attention, such as AI agents, monitoring alerts, CI failures, and RSS feeds. Instead of every one of those things pinging the user directly, they all flow into Chief first, and Chief decides what to do with each one: interrupt the person right away, hand the task off to an agent and check that the agent actually finished it, or quietly file it away in memory for later. The decision process runs in three stages, cheapest first. Simple hard coded rules catch obvious cases in microseconds, a similarity check catches near duplicates next, and only genuinely uncertain cases get sent to a language model for a judgment call. Chief also adjusts how easily it interrupts based on what it thinks the person is doing, so the same event might ring immediately at a desk but wait quietly in a digest at two in the morning. For its first week running, it stays in a shadow mode where it only shows what it would have done, without actually interrupting anyone. Every decision Chief makes is explainable: it records the reason, several scored factors, which rules fired, and what the language model call cost, and a command lets someone replay that reasoning after the fact. Chief also learns from simple thumbs up or down feedback on its calls, adjusting its per topic behavior over time, and the project includes benchmarks showing that learning process actually improving its accuracy across many simulated users. It runs entirely on the user's own machine, storing its state in a single SQLite database file and plain markdown files, with no cloud service or telemetry involved. Getting started takes one command that runs a fully offline demo with no setup, and a persistent version can be installed afterward to connect real agents and event sources. The project is written in Python and released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through what happens to an event as it moves through Chief's three decision stages.
prompt 2
Help me set up Chief to connect my CI alerts and RSS feeds without any cloud service.
prompt 3
Explain how shadow mode works during Chief's first week of running.
prompt 4
Show me how to give feedback on a decision so Chief learns my preferences over time.
prompt 5
Run the offline demo and explain the resulting interruption and dispatch counts to me.

Frequently asked questions

what is agent-chief fr?

A local first tool that filters every AI agent alert and feed through a judgment engine, deciding whether to interrupt you, dispatch work, or file it for later.

What language is agent-chief written in?

Mainly Python. The stack also includes Python, SQLite, DeepSeek.

How hard is agent-chief to set up?

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

Who is agent-chief for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.