Skip to content

Repository files navigation

Infinidev

PyPI Python Tests License: MIT

Infinidev is an autonomous AI coding agent for the terminal. It can inspect a repository, plan changes, edit code, run commands and tests, review its work, and keep project knowledge across sessions.

It works with hosted models through LiteLLM and with local models through Ollama.

Infinidev TUI

Install

Python 3.11 or newer is required. The recommended installation uses uv, which keeps Infinidev in an isolated tool environment:

uv tool install infinidev

Upgrade later with:

uv tool upgrade infinidev

You can also install it with pipx:

pipx install infinidev

Start

Run Infinidev from the project you want it to work on:

cd path/to/your/project
infinidev

Use /models manage to choose a provider and model, or /settings to edit the project configuration. By default, Infinidev expects Ollama at http://localhost:11434.

Useful command-line modes:

infinidev --no-tui                 # text-only interface
infinidev -p "explain this repo"   # one prompt, then exit
infinidev --continue               # resume the latest local session
infinidev --resume                 # choose a previous session

What it includes

  • A live terminal UI with task progress, diffs, files, logs, and context usage.
  • Plan-execute-summarize and staged execution for long, multi-step tasks.
  • File, shell, Git, web, code-intelligence, knowledge, and image tools.
  • Persistent, searchable working memory with recoverable tool evidence.
  • Model capability detection and native or text-based tool calling.
  • MCP server support; Ken is used for semantic project context when available.
  • Permission checks, deterministic completion gates, tests, and post-change review.
  • Image attachments, terminal image viewing, and opt-in image generation.

Essential commands

Command Purpose
/help Show commands and keybindings
/models manage Choose the active provider and model
/settings View or change project settings
/engine Select the task execution engine
/plan <task> Review a plan before execution
/mcp Show MCP server health
/findings Browse saved project knowledge
/reindex Rebuild the local code index
/clear Clear the transcript
/exit Quit

How it works

request
  -> read-only chat agent
  -> planner (when code work is needed)
  -> plan-execute-summarize loop
  -> tests and objective checks
  -> review
  -> result

Infinidev stores settings, history, logs, and its SQLite knowledge database in .infinidev/ inside the current project. Environment variables use the INFINIDEV_ prefix. Secrets and generated runtime state should not be committed.

Development

git clone https://github.com/Infinibay/infinidev.git
cd infinidev
uv sync
uv run pytest
uv run infinidev

Architecture and subsystem documentation live in docs/. Contributor guidance is in AGENTS.md.

License

Infinidev is available under the MIT License.

About

AI agent coder for small LLMs

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages