wizolt

wizolt working through a long session with background jobs, an edit preview, and a live status bar

A terminal coding agent I use, maintain, and customize, shipped as a self-contained Python package.

Safety

Use at your own risk. wizolt can edit files and run shell commands in the environment where it starts. It does not provide sandbox isolation; use a container or VM when needed.

What it is

wizolt does not introduce a new kind of coding agent. It combines familiar features — reading and editing files, running commands, follow-ups, sessions, diffs, MCP, and skills — into a tool I use personally.

It works on real repositories, including its own: I use wizolt to build and maintain wizolt. Everything ships in one self-contained Python package, so I can change the behavior directly whenever I want the workflow to work differently.

Wizolt is the former minacode, which began as the single-file nanocode. The implementation outgrew both earlier names; the project history remains continuous.

wizolt resuming a saved session

_{Resuming a saved session with its conversation and tool history.}

Highlights

Prompt caching: stable request prefixes help supported providers reuse earlier work, including during compaction. Check reported cache usage with /status.
Continuity for long tasks: automatic compaction carries working notes and recent tool activity forward, with older details available for recall. Resume saved conversation, tool history, and diffs with -c or --resume.
Precise edits: target a numbered source view or an exact, unique text match. Stale or ambiguous targets are rejected before the edit is applied.
Review changes in place: /diff shows both the latest round's changes and the net result of the session, without leaving the terminal.
Steer work as it happens: send a follow-up with Enter, hold a separate task with Tab, or interrupt with Ctrl-C once the draft is empty.
Background commands: let long-running commands continue as jobs, inspect their output, and wait for or stop them when needed.
Worker delegation: give a bounded task to a worker with its own provider and reusable context. Configure it with /worker; the agent delegates through Delegate.
Choose your provider: use OpenAI-compatible Chat Completions or Responses APIs, or Anthropic Messages. Optional provider-side web search shows searches and sources in the transcript.
MCP and skills: connect external tools through MCP and load reusable Markdown instructions on demand.

Install

Requires macOS or Linux, Python 3.11+, and uv.

uv tool install wizolt
wizolt --init-config

Add your provider to ~/.wizolt/config.toml:

[provider]
active = "default"

[provider.default]
url = "https://api.deepseek.com"
key = "sk-..."
model = "deepseek-flash"

Then run:

wizolt

Upgrade with uv tool upgrade wizolt.

Metadata

Release files for wizolt 0.56.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wizolt 0.56.1
File	Size	Uploaded
wizolt-0.56.1.tar.gz	510.3 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for wizolt 0.56.1
File	Interpreter	ABI	Platform	Reset
wizolt-0.56.1-py3-none-any.whl 558.5 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / wizolt-0.56.1.tar.gz

Download URL	wizolt-0.56.1.tar.gz
Size	510.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`3af4cd0c92bd98e9d594f8eca4c101a1ac8f0c2a50d0b2e1046ac3672bcf47fa`
BLAKE2b-256 checksum How to use checksums	`f93096215d5ef2bf2ec98f7885f823d634be2f532ab5daa14838ce1c2ffca07e`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / wizolt-0.56.1-py3-none-any.whl

Download URL	wizolt-0.56.1-py3-none-any.whl
Size	558.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`facca853a252b3503a0c072e6f30962bb830cc38b06b11e5b935cc01995e2654`
BLAKE2b-256 checksum How to use checksums	`dc8f416a3baadc5a720f34fd3c5d8616f0e113b1923cb1fa26049dc7db575418`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`