PBX CLAUDE.md

PBX CLAUDE.md is an instructions file for coding agents from mattiIce/PBX. It costs 4,606 tokens per session, scanned A, original, MIT.

A project guide for Warden VoIP, a Python system that handles internet-based phone calls and includes a TypeScript web interface. It lists the technology versions, commands, testing tools, and development setup.

In plain words
What is it for?
Use it when installing dependencies, running checks, linting, type-checking, testing, or navigating the Warden VoIP codebase.
Why use it?
It puts the project’s architecture and routine development commands in one place.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/mattiice/pbx/claude-md
Clone the repo
git clone --depth 1 https://github.com/mattiIce/PBX

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for PBX CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mattiice/pbx/claude-md.svg)](https://agentmods.dev/instructions/mattiice/pbx/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/mattiice/pbx/claude-md"><img src="https://agentmods.dev/badge/instructions/mattiice/pbx/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 4,606 This file is loaded in full into every session.
When invoked 4,606 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.04606 $0.04606
Opus 5 $0.02303 $0.02303
Sonnet 5 $0.00921 $0.00921
Haiku 4.5 $0.00461 $0.00461

Measured 4d ago against content hash f347f66af3be, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

PBX CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 363 lines

How it starts

The opening of the file, as written. The whole thing — 363 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md — Warden VoIP (PBX)

Project Overview

Warden VoIP is a comprehensive VoIP/PBX system built from scratch in Python 3.13+. It implements the full SIP protocol stack, RTP media handling, and an extensive feature set (76 modules) without depending on Asterisk or FreeSWITCH. The project includes a modern admin web interface built with TypeScript/Vite.

Quick Reference

Item Value
Language Python 3.13+ (backend), TypeScript 6.0 (frontend)
Node.js >=22 required
Package manager uv pip (Python), npm (frontend)
Build system hatchling (Python), vite 8.0 (frontend)
Test framework pytest 9+ (Python), jest 30 (frontend)
Linter/Formatter ruff 0.15 (Python), markdownlint-cli2 (Markdown)
Type checker mypy 2.1 (strict mode, Python), tsc (TypeScript)
Line length 100 characters
Entry point pbx/main.pypbx-server console script

Common Commands

# Install dependencies (development)
make install            # uv pip install -e ".[dev]"

# Run all checks (format + lint + test)
make check

# Linting and formatting
make lint               # ruff check + mypy
make lint-fix           # ruff check --fix
make format             # ruff format + isort fix
make format-check       # check only, no changes

# Testing
make test               # all tests (Python + JavaScript)
make test-python        # pytest only
make test-js            # jest only
make test-unit          # pytest -m unit
make test-integration   # pytest -m integration
make test-cov           # pytest with coverage report

# Development servers
make dev                # backend + frontend concurrently
make dev-backend        # Flask debug mode only
make dev-frontend       # Vite dev server only

# Run production
make run                # python main.py

# Docker
make docker-build       # docker compose build
make docker-up          # docker compose up -d
make docker-down        # docker compose down

# Pre-commit hooks
make pre-commit-install
make pre-commit-run

Read the full file on GitHub · 363 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 363 lines · 4,606 tokens per session scan A f347f66af3be

Subscribe to this mod's changes

PBX CLAUDE.md is an instructions file published in the GitHub repository mattiIce/PBX (2 stars, last pushed 2d ago), licensed MIT. It adds 4,606 tokens to every session, about $0.0230 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.