Aptitude Resolver banner

Aptitude Resolver

Python MCP Typer

A deterministic, package-manager-style resolver for AI skills.

Install

Install the published package as a CLI tool:

uv tool install aptitude-resolver
aptitude --help

Run it without a persistent install:

uvx aptitude-resolver --help

The package installs these console commands:

aptitude
aptitude-resolver
aptitude-mcp

aptitude is the command most users should run.

For MCP hosts that should launch the published package without a persistent install, use:

uvx aptitude-resolver mcp

Configure Registry Access

Registry-backed commands use the public Aptitude registry by default. Provide a read token:

export APTITUDE_READ_TOKEN=your-read-token

Override the registry URL only for local development or self-hosted registries:

export APTITUDE_SERVER_BASE_URL=http://localhost:8000
export APTITUDE_READ_TOKEN=reader-token

aptitude policy show can still inspect local policy without contacting the registry.

Usage

Launch the install-first wizard:

aptitude

Install a skill by exact slug:

uvx aptitude-resolver install python-patterns
aptitude install python-patterns --agent codex --scope project

In a terminal, omitted scope and agent targets are selected with the wizard UI, followed by a plan preview and final confirmation. Explicit destination flags skip those questions. --yes (-y) skips all prompts; JSON (--json), non-TTY, and CI runs remain unattended. Omitted destinations then default to Codex/project.

Search and inspect before installing:

uvx aptitude-resolver search "Documentation Writing"
uvx aptitude-resolver inspect "Documentation Writing"

Inspect effective local policy and config layers:

aptitude policy show

Replay an existing lockfile:

aptitude sync --lock aptitude.lock.json

Show the full command and flag surface:

aptitude manifest

MCP Server

Aptitude ships a local stdio MCP server for agents and MCP-compatible apps. The recommended MCP host configuration runs the published PyPI package locally through uvx:

{
  "mcpServers": {
    "aptitude": {
      "command": "uvx",
      "args": [
        "aptitude-resolver",
        "mcp"
      ],
      "env": {
        "APTITUDE_READ_TOKEN": "your-local-read-token"
      }
    }
  }
}

The MCP server process still runs locally. uvx only resolves the published package and starts its mcp command over stdio.

The MCP server exposes tools for search, inspect, resolve, policy inspection, install destination preview, install, and lock sync. Mutating install calls require explicit agents and scope; lock sync requires an explicit filesystem target.

If Aptitude is already installed as a persistent tool, MCP hosts can also use the direct executable:

{
  "mcpServers": {
    "aptitude": {
      "command": "aptitude-mcp",
      "args": [],
      "env": {
        "APTITUDE_READ_TOKEN": "your-local-read-token"
      }
    }
  }
}

Replace APTITUDE_READ_TOKEN with a token accepted by the target Aptitude Server.

What Works Today

discovery-backed query resolution
candidate version selection
recursive dependency graph resolution
policy filtering and graph governance
lockfile generation and replay
archive-based skill materialization from verified tar.zst artifacts
agent-ready exports for project, global, and custom skill roots
local config loading from aptitude.toml
CLI and MCP interfaces

Source

Source and contributor documentation live in the project repository:

https://github.com/aptitude-stack/resolver

Metadata

Release files for aptitude-resolver 0.2.19

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

Source distribution (sdist)

Source distribution for aptitude-resolver 0.2.19
File	Size	Uploaded
aptitude_resolver-0.2.19.tar.gz	100.6 kB	Sep 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aptitude-resolver 0.2.19
File	Interpreter	ABI	Platform	Reset
aptitude_resolver-0.2.19-py3-none-any.whl 152.3 kB Sep 5, 2026	Python 3	none	any	Details

Total release size: 252.9 kB

Release files / aptitude_resolver-0.2.19.tar.gz

Download URL	aptitude_resolver-0.2.19.tar.gz
Size	100.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`5f2c49491a70c00d55bedfc5e574998ecced0a5b1161b688a84b20164053c3d0`
BLAKE2b-256 checksum How to use checksums	`44d18a45043d35cd4473ffe0ed86d5c180a53323d02cc678e8d305aca4c648e1`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / aptitude_resolver-0.2.19-py3-none-any.whl

Download URL	aptitude_resolver-0.2.19-py3-none-any.whl
Size	152.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d2129a5f8c00d907e47d941fcc92177ef0a5e29acdfeb4c5ccd19384f0a931a7`
BLAKE2b-256 checksum How to use checksums	`8ffb84728f8ac3e30379faf75fbfc5e1388e4fad070ae7d2798dbc8a34270fb0`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`