# AI Time Estimator

> AI Time Estimator is an open-source AI tool for developer tools. Claude Code add-on that estimates task time in measured AI working minutes. It is available on CLI and self-hosted.

- **Kind:** Tool
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/noambrand/ai-time-estimator
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says the add-on makes Claude Code count the work in a task rather than guess a human-style schedule. A read-only subagent inspects the repository, looks at similar past requests, and writes smooth, expected and rough scenarios as counts of file reads, edits, command runs and fix loops. A script then converts those counts into P10, P50 and P90 minute ranges using rates measured from the user's own Claude Code transcripts.

After each turn, a Stop hook compares earlier estimates with what actually happened, leaving out time spent reading or approving. Once ten estimates have been scored, the ranges adjust themselves, and each answer shows its track record. The README states the model only counts operations while the scripts do the arithmetic.

It suits developers who use Claude Code and want a rough sense of how long an AI-driven change will take in actual session time. Everything runs locally with Python 3.9+ and no network calls, according to the README.

## Features

- **Counted scenario estimates:** Claude breaks a task into file reads, edits, lines written, command runs and fix loops across three scenarios.
- **Measured timing rates:** Per-turn, tool and output speeds are calibrated from the user's existing Claude Code history.
- **Percentile time ranges:** Each estimate is returned as P10, P50 and P90 minutes via a Monte Carlo simulation.
- **Automatic self-scoring:** A Stop hook records actual outcomes and corrects future ranges after ten scored estimates.
- **Backtest tool:** A backtest script replays past requests to check how often real times fall inside the predicted range.
- **Local-only operation:** The README states it makes no network calls and writes only to a folder under the user's .claude directory.

## Good for

- Estimating how long a feature or bug fix will take when working with Claude Code
- Getting AI-time ranges instead of human-day guesses from Claude for planning
- Reviewing how accurate past Claude Code estimates were using the backtest script
- Comparing estimated and actual session time to refine ongoing task planning

## FAQ

### What does it need to run?

The README says it needs Python 3.9+ on the PATH and nothing to pip install.

### Does it send data anywhere?

According to the README, everything stays on the machine, with no network calls and nothing sent elsewhere.

### How is it installed?

It can be installed as a Claude Code plugin with a /plugin install command, or by cloning the repository and running install.py.

### What happens if the Claude Code transcript format changes?

The README notes it depends on Claude Code's internal transcript format, and calibrate.py prints FORMAT CHECK FAILED if it stops recognizing model turns.

### Is AI Time Estimator free?

Yes. AI Time Estimator is open source, so you can use and self-host it for free.

### What are the best alternatives to AI Time Estimator?

The closest alternatives to AI Time Estimator are Reinwatch, ponytail, 30yr-uptime, Werkbank and Aq.

## Where this comes from

- Description: written from the project's README.

## Alternatives

- [Reinwatch](https://ai-powered.com/tools/reinwatch): Reinwatch is an open-source AI tool for developer tools.
- [ponytail](https://ai-powered.com/tools/ponytail): ponytail is an open-source AI tool for ai models and llm tooling.
- [30yr-uptime](https://ai-powered.com/tools/30yr-uptime): 30yr-uptime is an open-source AI tool for developer tools.
- [Werkbank](https://ai-powered.com/tools/werkbank): Werkbank is an open-source AI tool for developer tools.
- [Aq](https://ai-powered.com/tools/aq): Aq is an open-source AI tool for developer tools.
- [Recalc](https://ai-powered.com/tools/recalc): Recalc is an open-source AI tool for developer tools.
- [awesome-claude-code](https://ai-powered.com/tools/awesome-claude-code): awesome-claude-code is a free AI tool for coding.
- [TokenEconomizer](https://ai-powered.com/tools/tokeneconomizer): TokenEconomizer is an open-source AI tool for developer tools.

---
Source: https://ai-powered.com/tools/ai-time-estimator
