@timetotest/cli
v0.4.0
Published
Evidence-first AI testing agent — run UI, API, and code review checks from the terminal
Readme
TimetoTest CLI
Evidence-first AI QA
TimetoTest is an AI agent that tests your app and shows what passed, what failed, and what to fix. Describe the behavior you expect. TimetoTest runs UI checks, API checks, and code review checks, then returns evidence for faster triage.
Capabilities
- Browser Testing — Real browser automation with form fills, navigation, clicks, and validation
- API Testing — Validate endpoints, schemas, and response data
- End-to-End — Complete user journey validation across UI and API
- Regression — Catch breaking changes before production
- Code Review — Review pull request diffs for likely defects, risk patterns, and security-sensitive changes
- Bug Finder — Scheduled agents crawl your app to flag likely UI, API, and flow issues
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:3000Available Commands
ttt chat— Start an interactive testing session (UI, API, or code review).ttt test— Run a test from a plain-English prompt.ttt status <test-id>— Check the status of a running or completed test.ttt login— Authenticate via browser flow or token.ttt auth login— Compatibility alias forttt login.
How It Works
- Describe what you expect — Tell us the behavior you want verified. Plain English — environment, setup, and pass/fail criteria.
- AI plans the checks — Our AI breaks your request into UI flows, API calls, or code review steps — whatever fits.
- We run it — TimetoTest executes: navigates your app, hits your APIs, analyzes your code.
- Get evidence back — Screenshots, DOM snapshots, logs, traces, and code analysis — everything you need to triage fast.
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
- PR Code Review — Surface risky code changes with severity-tagged findings before merge
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
Links
- Website: https://timetotest.tech
- Docs: https://timetotest.tech/docs
No credit card required. Start with the free tier.
