Testing Arwaky

Autonomous test engine with self-healing capabilities. Built for AI agents that write and maintain tests 24/7.

For AI Agents:

• Autonomous test generation and execution
• Self-healing test code (auto-fix failures)
• Coverage auditing and quality gating
• Synthetic test data generation

Choose Your Path

Why Use Testing Arwaky

For Users

The Cost of NOT Using Testing Arwaky

┌─────────────────────────────────────────────────────────────────┐
│ What you're losing right now:                                     │
├─────────────────────────────────────────────────────────────────┤
│ ❌ Hours writing boilerplate tests manually                    │
│ ❌ Brittle tests that break on minor refactors                │
│ ❌ Low coverage on edge cases                                  │
│ ❌ Test suites that drift out of sync with code               │
│ ❌ Manual test data creation for boundary conditions          │
└─────────────────────────────────────────────────────────────────┘

Install

One-Liner (Linux/macOS)

curl -sSL https://raw.githubusercontent.com/rakaarwaky/testing-arwaky/main/install.sh | bash

One-Liner (Windows PowerShell)

iwr https://raw.githubusercontent.com/rakaarwaky/testing-arwaky/main/install.ps1 | iex

Manual Install

pip install testing-arwaky-mcp

Or with uv:

uv tool install testing-arwaky

Verify

agentic-test version
agentic-test --help

Quick Start

# Run tests with self-healing
agentic-test run tests/test_parser.py --heal --max-retries 3

# Analyze source code
agentic-test analyze src/my_module.py

# Audit coverage
agentic-test audit ./src --threshold 80

# Generate boilerplate tests
agentic-test generate src/my_module.py

# Generate synthetic test data
agentic-test generate-data emails --count 10

CLI Commands

Test Commands

Data & Migration

Performance & Workflow

Utility

Full list: agentic-test --help

Architecture

5-domain structure (same as lint-arwaky):

src/
├── agent/              # Lifecycle, orchestration, DI container
├── capabilities/       # Thinking logic — test execution, healing, analysis
├── infrastructure/     # Adapters — pytest runner, file system, transports
├── surfaces/           # Interfaces — CLI (Click), MCP (FastMCP)
└── taxonomy/           # Value objects, interfaces, models

Dependency Rules

surfaces      → capabilities       OK
surfaces      → infrastructure     OK
capabilities  → infrastructure     OK (uses interfaces from taxonomy)
infrastructure → taxonomy          OK
agent         → everything         OK (wiring layer)

Self-Healing

Testing Arwaky can automatically fix common test failures:

Example healing loop:

1. Run test → FAIL (ImportError)
2. Healer detects missing sys.path
3. Applies fix, retries → PASS

Configuration

Environment Variables

Contributing

See CONTRIBUTING.md for details on:

• Adding new test capabilities
• Adding CLI commands
• Adding MCP tools
• Testing guidelines

License

MIT License. See LICENSE.