explaingit

seangeng/agentblip

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A tool that syncs your Slack status with what your local AI coding agents (Claude Code, Codex) are doing, so teammates see you as busy instead of idle.

Mindmap

mindmap
  root((agentblip))
    What it does
      Updates Slack status
      Shows agent activity
      Clears when idle
    Tech stack
      TypeScript
      Node daemon
      Cloudflare Workers relay
    Use cases
      Signal busy status to teammates
      Avoid idle looking busy time
      See blocked agents
    Audience
      Developers using AI agents
      Remote teams
    Privacy
      Local formatting only
      Relay sees text only
      Rolling expiration

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 build with it?

USE CASE 1

Show teammates on Slack that you are actively supervising AI agent sessions.

USE CASE 2

Get an automatic Slack status change when an agent finishes or gets blocked waiting for you.

USE CASE 3

Let other custom tools report their activity into the same status system via a simple HTTP request.

What is it built with?

TypeScriptNode.jsCloudflare WorkersSlack API

How does it compare?

seangeng/agentblip0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a Slack workspace and running the setup command to connect it.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

agentblip solves a small but real problem for people who run AI coding agents like Claude Code or Codex. When you kick off a few agent sessions and step back to review their output, your Slack status still shows as idle, even though you are effectively busy. This tool turns what your local agents are doing into your Slack status automatically, so teammates can see things like "claude agent working" or "3 agents working" instead of a plain green dot that says nothing. You install it with npm, run a setup command that connects it to Slack and installs some hooks, then start a small background program called a daemon. From there, Claude Code sessions are picked up automatically through hooks, and Codex sessions through a watcher process. Other tools can report their activity too, by sending a simple web request to the daemon running on your own machine. Privacy is a core design point. The daemon on your computer is the only part of the system that ever sees the details of your sessions, such as prompts, file paths, or project names. It formats a short status message locally, and only that formatted text, an emoji, and an expiration time get sent onward to a small relay service, which then updates your Slack status. You can control how much detail is shown, from a generic "heads down with agents" message all the way up to naming the specific task an agent is finishing. Every status update also carries an expiration timer, so if your laptop sleeps or the daemon crashes, Slack clears the status on its own rather than showing you as busy forever. Configuration, including redaction rules for sensitive project names and custom message templates, lives in a local JSON file. The project is written in TypeScript, is MIT licensed, and is still very new with no stars yet.

Copy-paste prompts

Prompt 1
Walk me through installing agentblip and connecting it to my Slack workspace.
Prompt 2
Explain what the different granularity settings in agentblip's config do and which one fits a small team.
Prompt 3
Show me how to write a redaction pattern in agentblip's config to hide a confidential project name.
Prompt 4
Help me set up agentblip so a custom script can report its status via the local HTTP endpoint.

Frequently asked questions

What is agentblip?

A tool that syncs your Slack status with what your local AI coding agents (Claude Code, Codex) are doing, so teammates see you as busy instead of idle.

What language is agentblip written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Cloudflare Workers.

What license does agentblip use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is agentblip to set up?

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

Who is agentblip for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.