Aptitude Resolver banner

Aptitude Resolver

PyPI GitHub Python uv 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 query:

aptitude install "Postman Primary Skill"
aptitude install "Postman Primary Skill" --agent codex --scope 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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.16)

Owner

PyPI data
Data sourced directly from PyPI's database.

Requires

Python >=3.10

Provides Extra

dev

Tags

ai cli mcp package-manager resolver skills

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aptitude_resolver-0.2.7.tar.gz (95.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aptitude_resolver-0.2.7-py3-none-any.whl (146.7 kB view details)

Uploaded Python 3

File details

Details for the file aptitude_resolver-0.2.7.tar.gz.

File metadata

  • Download URL: aptitude_resolver-0.2.7.tar.gz
  • Upload date:
  • Size: 95.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}

File hashes

Hashes for aptitude_resolver-0.2.7.tar.gz
Algorithm Hash digest
SHA256 ecf163767ffcff8252c8170be4c1b81c7a26106f117e720d45c70b5934e9f91e
MD5 964a372c4fd1711c4cb6f2fe69d922fe
BLAKE2b-256 7103d22f5f82d2bbd51d0838c9879d2f0845e692090fa98f1e9df39f5d293551

See more details on using hashes here.

File details

Details for the file aptitude_resolver-0.2.7-py3-none-any.whl.

File metadata

  • Download URL: aptitude_resolver-0.2.7-py3-none-any.whl
  • Upload date:
  • Size: 146.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}

File hashes

Hashes for aptitude_resolver-0.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 5dd07a839dc7573fe4212c2ceb91b8a0f39fc99f94158cd066e4ad7c0d0a8074
MD5 7e1e0abe0652abf79db79bbcc4e79dbd
BLAKE2b-256 cbed53d780d47969b1c6a03ed936918e9b0e02978f5e83f757a2659344e54a40

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

This release

0.2.7 This release

2 files

0.2.6

2 files

0.2.5

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page