TimetoTest CLI

Ship Faster with AI Agents That Don't Flake

Give our agent a URL and a goal. It plans, executes, and self-heals end-to-end tests in an isolated environment. Built for developers and QA engineers who demand verifiable evidence, not black-box magic.

Capabilities

• UI Testing — Real browser automation with semantic DOM understanding
• API Testing — Validate endpoints, schemas, and response data
• Code Analysis — Local code analysis for bug finding and quality checks
• End-to-End — Complete user journey validation
• Regression — Catch breaking changes before production

Quick Start

npm install -g @timetotest/cli

# Authenticate
ttt login

# Start an interactive session
ttt

# Run a test with a prompt
ttt test "Verify the login flow works" --base-url http://localhost:3000

Available Commands

• ttt chat - Interactive chat/testing session (--mode ui|api|code).
• ttt test - Opens chat with a prefilled test prompt.
• ttt status <test-id> - Fetch test status from backend.
• ttt login - Authenticate via browser flow or token.

How It Works

1. Describe Your Test — Write your testing goal in plain English. No scripts, no complex selectors.
2. Smart Test Planning — The agent analyzes your application and builds a comprehensive test plan.
3. Automated Execution — Watch the agent execute in a real browser, interacting exactly like a human.
4. Actionable Results — Get clear reports with screenshots, video logs, and step-by-step diagnostics.

Technical Excellence

• Semantic DOM Parsing — Understands context, not just pixels. No brittle visual-only testing.
• LLM-Powered Planning — Decomposes complex flows into atomic, verifiable actions.
• Self-Healing Tests — Adapts to UI changes automatically. Stop maintaining broken selectors.
• Isolated Execution — Tests run in ephemeral sandboxes destroyed after every run.
• Evidence-Based Reports — Screenshots, video logs, and step-by-step diagnostics for every test.

Use Cases

• Regression Testing — Automated suites that run on every deploy
• E2E Flow Validation — Validate complete user journeys without writing test scripts
• API Contract Testing — Automatic schema validation and edge case handling
• Sprint QA Automation — Ship faster by automating QA within your sprint cycles
• Bug Reproduction — Turn vague bug reports into actionable test cases with evidence

Code Mode

Analyze your local codebase for bugs, run linters, and execute tests — no GitHub integration required.

# Start in code mode
ttt chat --mode code

# Example prompts
> "Find potential null pointer issues in src/api/"
> "Run ESLint and fix the errors"
> "Find and run the auth tests"

Requirements

• Node.js 18+
• macOS, Linux, or Windows
• Chrome/Chromium for UI testing

Links

• Website: https://timetotest.tech
• Docs: https://timetotest.tech/docs

No credit card required • Free tier forever