PACKAGE EXPLORERView in registry

af-toolkit

PyPI

Fast AF developer tooling for AI agents

Versions collected1

Direct dependencies7From release 0.1.0

Last observed20 Oct, 21:15 UTC

README

Version 0.1.0 documentation

AgentForge Toolkit (af-toolkit)

Fast AF developer tooling for AI agents.

Build, test, slice, audit, evaluate, and sandbox Model Context Protocol (MCP) servers and agent trajectories.

Key Modules & Capabilities

+-------------------------------------------------------------------------+
|                           AgentForge Toolkit                            |
+-------------------+-------------------+---------------------------------+
| Forge             | Slice             | Audit & Observability           |
| - OpenAPI to MCP  | - AST Skeletons   | - Trajectory Diagrams & Diffs   |
| - Mock Servers    | - Repo Slicer     | - Safety & Policy Scanner (A-F) |
| - Python to MCP   | - Git Diff Slicer | - Benchmark Comparator          |
| - Docker Exporter | - Multi-Model Tok | - Cost Estimator ($)            |
| - Client Exporter | - Prompt Wrappers | - PII Redactor & Failure Diag   |
| - Compliance Test | - JSON & MD Slicer| - Commit Message Generator      |
+-------------------+-------------------+---------------------------------+
| Gateway & REPL    | Eval & Sandbox    | Studio & DX                     |
| - Multi-Server GW | - SWE-bench Eval  | - Interactive Web Workbench     |
| - Stdio Debugger  | - Git Snapshot    | - System Doctor & Initializer   |
| - Polyglot Bridge | - Auto-Rollback   | - Antigravity Skill Exporter    |
| - Interactive REPL| - Resource Bounds | - IDE Agent Rules Exporter      |
+-------------------+-------------------+---------------------------------+

Quickstart

1. Installation

pip install af-toolkit

2. Generate an MCP Server from OpenAPI

af forge generate api_spec.json -o server.py --service github

3. Generate Client Configuration

af forge config server.py --client all

4. Slice Code & Repositories for LLM Prompts

af slice-repo ./my_project --budget 6000 -o repomap.md
af tokens ./my_project/main.py

5. Audit Trajectory Logs

af audit report trajectory.jsonl -o audit_report.md
af audit safety trajectory.jsonl
af audit cost trajectory.jsonl --model claude-3-5-sonnet

6. Interactive MCP Debugger & REPL

af mcp-repl "python server.py"

7. Run Agent Benchmark Evaluations

af eval run tasks.jsonl --agent-cmd "agy" -o eval_report.md

8. Ephemeral Sandbox with Auto-Rollback

af sandbox run "pytest tests/" --rollback

9. Launch AgentForge Studio

af studio --port 8000

CLI Command Reference

Command	Description
`af forge generate <spec>`	Generate FastMCP server from OpenAPI 3.0/3.1 or Swagger 2.0.
`af forge mock <spec>`	Generate offline mock MCP server with synthetic responses.
`af forge python <source.py>`	Convert Python functions directly into MCP tools.
`af forge doc <server.py>`	Generate Markdown documentation tool catalog.
`af forge docker <server.py>`	Generate Dockerfile and docker-compose.yml.
`af forge config <server.py>`	Export ready-to-use JSON config for Claude Desktop / Cursor / Antigravity.
`af test-mcp <server_or_spec>`	Validate MCP schemas, signatures, and docstrings.
`af slice <file.py>`	AST code skeletonization under token budgets.
`af slice-repo <dir>`	Repository architecture map for system prompts.
`af tokens <target>`	Multi-model token calculator across GPT-4o, Claude, Gemini, DeepSeek.
`af slice-json <file>`	Prune large JSON/YAML data files.
`af slice-md <file>`	Extract Markdown headings and lead sections.
`af audit report <log>`	Trajectory metrics, Mermaid sequence diagrams, and git diff snippets.
`af audit safety <log>`	Security scan for leaked keys, destructive commands, loop storms.
`af audit compare <l1> <l2>`	Side-by-side benchmark comparison between agent runs.
`af audit cost <log>`	Calculate dollar cost ($) across LLM models.
`af audit redact <log>`	Sanitize PII, credentials, and IPs in trajectory logs.
`af audit diagnose <log>`	Cluster tool errors and generate parameter suggestions.
`af audit commit-msg <log>`	Generate conventional commit message from touched files.
`af mcp-repl <server_cmd>`	Interactive stdio terminal REPL for debugging MCP servers.
`af gateway --servers <cmds>`	Multi-server MCP multiplexer gateway.
`af eval run <tasks.jsonl>`	Run agent evaluation harness and generate scorecards.
`af sandbox run <command>`	Execute command inside snapshot-guarded sandbox.
`af sandbox snapshot/rollback`	Manage git working directory snapshots.
`af export-skill <server.py>`	Export Antigravity skill package (SKILL.md, scripts/, references/).
`af export-rules`	Export .cursorrules, .windsurfrules, or AGENTS.md.
`af config set/list/path`	Manage credentials in ~/.af/auth.toml.
`af config export-env`	Export credentials to .env.
`af doctor`	System & environment diagnostics.
`af init [--ci]`	Scaffold project and CI/CD workflows.
`af studio`	Launch FastAPI web workbench.

License

MIT License. Created for AI agent developers.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.1.0	16 Aug 2026	7

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING

andreapallotta/af-toolkit

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 21:15 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:cd6b57c70ba7db35d1e38c6be4ffd5e1f7a526f99b56dabab07765475d40a0d3