Aptitude Resolver
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:
aptitudeaptitude-resolveraptitude-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.zstartifacts - 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:
Metadata
Release files for aptitude-resolver 0.2.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aptitude_resolver-0.2.18.tar.gz | 99.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aptitude_resolver-0.2.18-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 250.3 kB
Release files / aptitude_resolver-0.2.18.tar.gz
| Download URL | aptitude_resolver-0.2.18.tar.gz |
|---|---|
| Size | 99.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
299ad7a3efb82e501540291348038b431007f5057f6925a196c2ad15e0283036
|
|
BLAKE2b-256 checksum How to use checksums |
1d158447d7e3ede7ada55684e2e27f613c56548f842f580a980eff68619508c9
|
| Upload date | |
|
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.18-py3-none-any.whl
| Download URL | aptitude_resolver-0.2.18-py3-none-any.whl |
|---|---|
| Size | 150.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
279867b8b491a42ef12363271222ac9ef12711b3309c15ec4e6cc3acd6170d8e
|
|
BLAKE2b-256 checksum How to use checksums |
99669eb3f1fdaf8e20c5f352282ae1173f2f8f0e5b9452f8251fe140f38e9b5a
|
| Upload date | |
|
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}
|
