Skip to main content
Glama
bakalagoin

codinfy-agent-monitor

by bakalagoin

Codinfy Agent Monitor

Real-time mission control for AI engineering teams.

Observe agents, context, limits, workflows, Git, security and model economy from one local-first command center.

CI Version MCP Node License

Stars Forks Last commit TypeScript

Overview · Quick start · Command center · MCP API · Architecture · Security · Contributing · License


✦ The mission

AI agents move fast. Their context, tool calls, file changes, limits and failures usually remain scattered across terminals and provider interfaces. Codinfy Agent Monitor turns that invisible activity into a single operational picture.

Mission system

What it reveals

🛰️

Agent Radar

Active, idle, thinking, running, blocked, failed and completed agents

Context & Limits

Context, current rate, daily and weekly usage with official/estimated provenance

Workflow Pulse

Tasks, owners, progress, blockers, files and a real-time event timeline

AI Credit Saver

Model Need Score, safer model category and estimated token/cost savings

Safe Guard

Secret scanning, sensitive-file detection and review before commit

Dev Operations

Git state, tests, builds, environment and public-ready checks

Codix Observer

Context-aware recommendations for risk, economy and next actions

Universal MCP

Claude Code, Codex, Cursor, Windsurf and other MCP-compatible hosts

IMPORTANT

Exact provider limits are displayed asofficial only when a host or adapter supplies them directly. Otherwise the interface clearly enables estimate mode. Codinfy Agent Monitor never presents a local estimate as provider truth.

Related MCP server: WhenLabs/When

⚡ Launch in 60 seconds

git clone https://github.com/bakalagoin/codinfy-agent-monitor.git
cd codinfy-agent-monitor
corepack enable
pnpm install
pnpm build
pnpm --filter codinfy-agent-monitor link --global
codinfy-agent-monitor init
codinfy-agent-monitor status

Your private operational data is created inside .codinfy-agent-monitor/ and excluded from Git.

# Animated terminal mission control
codinfy-agent-monitor watch

# Local Fastify + WebSocket dashboard
codinfy-agent-monitor web

Open http://localhost:3579/dashboard. The server binds to 127.0.0.1 by default.

Without a global link:

pnpm codinfy status
pnpm codinfy watch
pnpm mcp

◫ Command center

╭────────────────── Codinfy Agent Monitor ──────────────────╮
│ Project: codinfy-agent-monitor                             │
│ Active AI: Codex · Command: /codinfy                       │
│ MCP: codinfy-agent-monitor                                 │
├────────────────────────────────────────────────────────────┤
│ Context used           ██████████████░░░░░░ 68% official   │
│ Current rate           ████████░░░░░░░░░░░░ 42% estimated  │
│ Daily limit            ████████████████░░░░ 81% estimated  │
│ Weekly limit           ████████░░░░░░░░░░░░ 42% estimated  │
├────────────── AI Credit Saver & Smart Router ──────────────┤
│ Current model: Premium Reasoning                           │
│ Recommended: Standard Code · estimated saving: 45%         │
│ Model switch: confirmation required                        │
├────────────────────────────────────────────────────────────┤
│ Agents: 5 active · 3 idle · Workflow: 7 tasks              │
│ ✓ secrets.clean  ✓ tests.passed  ✓ build.passed            │
╰────────────────────────────────────────────────────────────╯
  © CODINFY PLATFORMS SASU · codinfy.com

Interface

Command

Experience

Snapshot

codinfy-agent-monitor status

Fast operational overview

Animated TUI

codinfy-agent-monitor watch

Live terminal bars and agent activity

Web glass UI

codinfy-agent-monitor web

Responsive local dashboard + WebSocket

MCP server

codinfy-agent-monitor mcp

Tool API for compatible AI environments

Slash command

/codinfy

Native host-oriented monitoring flow

⌘ Operator commands

codinfy-agent-monitor status
codinfy-agent-monitor agents
codinfy-agent-monitor context
codinfy-agent-monitor limits
codinfy-agent-monitor workflow
codinfy-agent-monitor tasks
codinfy-agent-monitor timeline
codinfy-agent-monitor files
codinfy-agent-monitor health
codinfy-agent-monitor git
codinfy-agent-monitor tests --run
codinfy-agent-monitor build --run
codinfy-agent-monitor secrets
codinfy-agent-monitor attribution-check
codinfy-agent-monitor review
codinfy-agent-monitor public-ready
codinfy-agent-monitor saver
codinfy-agent-monitor budget
codinfy-agent-monitor cost
codinfy-agent-monitor model-score "audit the authentication architecture"
codinfy-agent-monitor model-advice "update the README"
codinfy-agent-monitor economy-plan

The router recommends configurable categories — fast_cheap, standard_code, advanced_code or premium_reasoning — instead of hard-coding provider model names. It never changes the active model without confirmation.

codinfy-agent-monitor language auto
codinfy-agent-monitor language fr
codinfy-agent-monitor level beginner
codinfy-agent-monitor level expert
codinfy-agent-monitor safe on
codinfy-agent-monitor environment
codinfy-agent-monitor doctor

⬡ MCP Tool API

Start the local stdio server:

codinfy-agent-monitor mcp
{
  "mcpServers": {
    "codinfy-agent-monitor": {
      "command": "codinfy-agent-monitor",
      "args": ["mcp"]
    }
  }
}

Tool domain

MCP tools

Status

monitor.status, monitor.open_dashboard, monitor.get_attribution

Agents

monitor.list_agents, monitor.register_agent, monitor.update_agent_state

Usage

monitor.get_context_usage, monitor.get_rate_limit_status, monitor.get_daily_usage, monitor.get_weekly_usage

Model economy

monitor.get_model_advice, monitor.get_model_score, monitor.get_budget_status, monitor.get_economy_plan

Workflow

monitor.create_task, monitor.update_task, monitor.list_tasks, monitor.get_workflow, monitor.timeline

Engineering

monitor.git_status, monitor.test_status, monitor.build_status, monitor.environment_status

Trust

monitor.scan_secrets, monitor.review_before_commit, monitor.alerts, monitor.recommendations

Reports

monitor.export_report, monitor.get_cost_estimate

The integration test launches the built stdio server, connects an MCP client, lists tools and calls monitor.get_attribution.

⇄ AI environment adapters

Ready-to-copy templates live under templates/. If a host does not expose custom slash commands, the CLI, TUI and local web dashboard remain universal fallbacks.

⎔ Architecture

flowchart LR
  subgraph Hosts[AI environments]
    Claude[Claude Code]
    Codex[Codex]
    Cursor[Cursor]
    Windsurf[Windsurf]
  end

  subgraph Interfaces[Codinfy interfaces]
    MCP[MCP stdio · 30 tools]
    CLI[CLI · /codinfy]
    TUI[Animated Ink TUI]
    WEB[Fastify + WebSocket]
  end

  CORE[Core monitoring engine]
  DB[(Local SQLite · WAL)]
  OPS[Git · Tests · Build · Environment]
  TRUST[Secret Scanner · Safe Guard · Review]
  ROUTER[AI Credit Saver · Model Router]

  Claude & Codex & Cursor & Windsurf --> MCP
  MCP & CLI & TUI & WEB --> CORE
  CORE --> DB
  CORE --> OPS
  CORE --> TRUST
  CORE --> ROUTER
packages/core          domain, SQLite, Git, security, model router, reports
packages/cli           codinfy-agent-monitor + codinfy-monitor binaries
packages/tui           animated Ink terminal mission control
packages/server        local Fastify + WebSocket glass dashboard
packages/mcp-server    stdio MCP server codinfy-agent-monitor
packages/adapter-*     Claude Code, Codex, Cursor and Windsurf metadata
templates/             ready-to-copy /codinfy and MCP integrations

See the full architecture guide.

⛨ Trust center

Control

Default

Data location

Local .codinfy-agent-monitor/ directory

Dashboard exposure

Loopback only — 127.0.0.1

Secret output

Redacted before CLI, MCP and report output

Project commands

Tests/build run only with explicit --run

Model switching

Never automatic; confirmation is mandatory

Git behavior

Read-only monitoring; no implicit commit or push

Public-ready gate

Secrets + attribution + tests + build + sensitive files

CAUTION

Never paste API keys, tokens, passwords,.env content, private logs or production credentials into a public issue. Use private vulnerability reporting.

Read the Security Policy · Read the threat model

▣ Requirements

Runtime

Requirement

Node.js

>= 22.13.0 for the built-in node:sqlite local store

pnpm

>= 10

Git

Recommended for file and repository monitoring

Platforms

Windows, macOS and Linux by design

◇ Build with us

corepack pnpm install
pnpm check

pnpm check runs lint, 15 tests — including a live MCP stdio client/server test — TypeScript build and formatting validation.

Guide

Purpose

CONTRIBUTING.md

Local setup, branch flow and PR checklist

SECURITY.md

Private disclosure and support policy

LICENSE

Codinfy Attribution License 1.0

CHANGELOG.md

Release history

Documentation

Installation, usage, MCP and security

◉ Local storage

.codinfy-agent-monitor/
├── config.json
├── metrics.sqlite
├── sessions/
├── agents/
├── workflows/
├── logs/
├── reports/
└── cache/

The entire directory is ignored by Git. .env*, credentials, logs, build output and local reports are never intended for publication.

⚖ License & attribution

This public repository is distributed under the custom Codinfy Agent Monitor Attribution License 1.0. Because it protects product identity and carries enhanced attribution conditions, it may be classified as source-available rather than OSI open source. Qualified legal review is recommended before high-stakes reliance.

The following identity must remain visible in copies, forks, distributions, interfaces, reports, exports and modified versions:

Codinfy Agent Monitor
/codinfy
codinfy-agent-monitor
© CODINFY PLATFORMS SASU
codinfy.com
Created by CODINFY PLATFORMS SASU
Bakala Goin — Founder & CEO

Connect with Codinfy

Website Facebook Instagram LinkedIn

Bakala Goin — Founder & CEO

Facebook Instagram LinkedIn TikTok X

Created by CODINFY PLATFORMS SASU Bakala Goin — Founder & CEO codinfy.com

© CODINFY PLATFORMS SASU · codinfy.com

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bakalagoin/codinfy-agent-monitor'

If you have feedback or need assistance with the MCP directory API, please join our Discord server