Skip to main content

Wizolt logo: a blue hooded terminal mage holding a lightning staff
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.55.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.55.1
File Size Uploaded
wizolt-0.55.1.tar.gz 484.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wizolt 0.55.1
File Interpreter ABI Platform
wizolt-0.55.1-py3-none-any.whl Python 3 none any Details

Total release size: 1.0 MB

Release files / wizolt-0.55.1.tar.gz

Download URL wizolt-0.55.1.tar.gz
Size 484.9 kB
Tags Source
SHA-256 checksum
How to use checksums
d0f36affeb9fceb4d9d4b8e5874c13b9cd7e0fa3a342f254fd193025d98b27a2
BLAKE2b-256 checksum
How to use checksums
ea6a9759f7aad4f03601a3fd1e41b43d2656a201dff3686161b4722e3d99764d
Upload date
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.55.1-py3-none-any.whl

Download URL wizolt-0.55.1-py3-none-any.whl
Size 525.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4ec136ac0bbbf7d22b4a57d12120068b402585b6d4c476c263deb695760f11ec
BLAKE2b-256 checksum
How to use checksums
3da0ad6f4b56f04d153f9fed4705568f2e7f664b8479828b1f41e5d6287a3f79
Upload date
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 history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page