squackit

Semi-QUalified Agent Companion Kit. A code intelligence toolkit that works two ways: as an MCP server for AI agents, and as a CLI for humans.

Built on pluckit (CSS selectors over ASTs) and fledgling (SQL macros over DuckDB).

Install

pip install squackit

CLI usage

# Run any tool from the shell
squackit tool list
squackit tool view "src/**/*.py" ".fn#main"
squackit tool find_names "**/*.py" ".class"
squackit tool complexity "src/**/*.py" ".fn"

# JSON output for scripting
squackit --json tool find "src/**/*.py" ".fn"

# Pluckit chain queries
squackit pluck "src/**/*.py" find .fn containing cache names
squackit pluck "src/api.py" find .class#Handler children find .fn names

# Start the MCP server
squackit mcp serve

Tool names resolve in three conventions: find_names, find-names, FindNames. Tab completion is built in (eval "$(_SQUACKIT_COMPLETE=bash_source squackit)").

What agents get via MCP

~35 tools — CSS-selector code queries (via pluckit), file I/O, git history, doc navigation, conversation analytics, and diagnostics. The exact set is dynamic (fledgling macros + pluckit tools + pluckins); a full install exposes ~40 MCP tools including the workflows below.
4 compound workflows — explore, investigate, review, search
3 prompt templates — pre-loaded with live project data
5 resources — project overview, docs, git status, session log, diagnostics
pluck tool — full pluckit chain grammar for multi-step AST queries, with mutation safety (blocked by default, opt-in via allow_mutations=true)
Smart defaults — infers language, doc layout, main branch automatically
Token-aware output — configurable truncation with max_results/max_lines

Architecture

Layer 4   Consumers (Claude Code, agents, IDE extensions)
              │
Layer 3b  squackit ─── CLI + MCP server + intelligence
              │        smart defaults, caching, truncation,
              │        workflows, pluckit tools, mutation safety
              │
Layer 3a  pluckit ──── fluent Python API (CSS selectors over ASTs)
              │
Layer 2   fledgling ── SQL macros + Python bundler
              │
Layer 0   DuckDB extensions (sitting_duck, markdown, duck_tails, read_lines)

Pluckit tools take priority over fledgling equivalents when both provide a capability (e.g., pluckit's find supersedes fledgling's find_definitions).

Note: pluckit is published on PyPI as ast-pluckit. The import name is pluckit.

Documentation

Full docs at squackit.readthedocs.io.

License

Apache 2.0

Download files

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

Source Distribution

squackit-0.8.1.tar.gz (339.6 kB view details)

Uploaded Aug 17, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

squackit-0.8.1-py3-none-any.whl (70.6 kB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file squackit-0.8.1.tar.gz.

File metadata

Download URL: squackit-0.8.1.tar.gz
Upload date: Aug 17, 2026
Size: 339.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for squackit-0.8.1.tar.gz
Algorithm	Hash digest
SHA256	`bed789aa98e47e1bbd78ff6ccfc811573faa0cbf4f67685243eab3d135604be2`
MD5	`b1546967a87bba55efed0e75dd67b2ab`
BLAKE2b-256	`adeb8fa372d5a16d539f27cb247d92adab264a2412c1d750449795a110563b81`

See more details on using hashes here.

Provenance

The following attestation bundles were made for squackit-0.8.1.tar.gz:

Publisher: release.yml on teaguesterling/squackit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: squackit-0.8.1.tar.gz
- Subject digest: bed789aa98e47e1bbd78ff6ccfc811573faa0cbf4f67685243eab3d135604be2
- Sigstore transparency entry: 2498843217
- Sigstore integration time: Aug 17, 2026
Source repository:
- Permalink: teaguesterling/squackit@474a4bf32de96bd9c1b47ef6f276ddcb3d5cb64b
- Branch / Tag: refs/tags/v0.8.1
- Owner: https://github.com/teaguesterling
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@474a4bf32de96bd9c1b47ef6f276ddcb3d5cb64b
- Trigger Event: push