Metadata-Version: 2.4
Name: squackit
Version: 0.3.1
Summary: Semi-QUalified Agent Companion Kit — the stateful intelligence + MCP server layer for fledgling-equipped agents.
Project-URL: Homepage, https://github.com/teaguesterling/squackit
Project-URL: Documentation, https://squackit.readthedocs.io
Project-URL: Repository, https://github.com/teaguesterling/squackit
Project-URL: Issues, https://github.com/teaguesterling/squackit/issues
Author: Teague Sterling
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai-agents,code-intelligence,duckdb,fledgling,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: ast-pluckit>=0.7.0
Requires-Dist: click>=8.0
Requires-Dist: fastmcp>=3.0
Provides-Extra: docs
Requires-Dist: mkdocs-exclude>=1.0; extra == 'docs'
Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.9; extra == 'docs'
Description-Content-Type: text/markdown

# squackit

[![PyPI](https://img.shields.io/pypi/v/squackit)](https://pypi.org/project/squackit/)
[![Docs](https://readthedocs.org/projects/squackit/badge/?version=latest)](https://squackit.readthedocs.io/)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)

**Semi-QUalified Agent Companion Kit.** The stateful intelligence + MCP server
layer for [fledgling](https://github.com/teaguesterling/fledgling)-equipped
agents.

squackit wraps fledgling's SQL macros (via
[pluckit](https://github.com/teaguesterling/pluckit) — `pip install ast-pluckit`) with smart defaults,
token-aware output, session caching, compound workflows, an MCP server,
prompt templates, and live resources.

## Install

```bash
pip install squackit
```

## Run

```bash
squackit
```

Starts the FastMCP server on stdio. Connect it to Claude Code, Cursor, or any
MCP-compatible client.

## What agents get

- **25+ tools** — code search, AST analysis, doc browsing, git history, diagnostics
- **4 compound workflows** — `explore`, `investigate`, `review`, `search`
- **3 prompt templates** — pre-loaded with live project data
- **5 resources** — always-on project overview, docs, git status, session log
- **Smart defaults** — infers language, doc layout, main branch automatically
- **Token-aware output** — truncation with head+tail hints, automatic bypass

## Architecture

```
squackit → ast-pluckit → fledgling-python → fledgling (SQL) → DuckDB extensions
```

> **Note:** pluckit is published on PyPI as
> [`ast-pluckit`](https://pypi.org/project/ast-pluckit/). The Python import
> name is still `pluckit`.

squackit is the opinionated top layer. It adds session state, MCP protocol,
and intelligence heuristics on top of the stateless query layers below it.

## Documentation

Full docs at **[squackit.readthedocs.io](https://squackit.readthedocs.io/)**.

## License

Apache 2.0
