ace-wrapper 0.1.0

Augment Context Engine (ACE) Wrapper

ACE Wrapper

Semantic codebase retrieval using the Augment Context Engine through a small ace command.

Use it when the relevant identifiers are unknown and the query is about behavior, intent, architecture, or data flow. Treat results as candidate files, then read the returned files and confirm exact identifiers or call sites with literal search.

Prerequisites

Authenticate the Augment CLI before searching:

auggie login

Install

From this repository:

uv tool install .

From a published package:

uv tool install ace-wrapper

Usage

timeout 60s ace "How is the authentication flow implemented?" -w /path/to/project/root
timeout 60s ace "Find where uploaded files are validated and stored" -w /path/to/project/root
timeout 60s ace "用户登录流程在哪里实现" -w /path/to/project/root

Use --verbose for debug logs:

timeout 60s ace "config loading" -w /path/to/project/root --verbose

Reliability Boundaries

• ACE is a candidate-file generator, not proof that a feature exists.
• Verify important conclusions by reading files and using exact search.
• Split unrelated workflows into separate queries.
• Use literal search for exact identifiers, error strings, routes, events, and config keys.

More usage guidance lives in references/guide.md.

Release

Publishing is handled by GitHub Actions. Create and push a version tag to build, publish to PyPI, and create a GitHub Release:

git tag v0.1.0
git push origin v0.1.0

The PyPI publish job uses Trusted Publishing, so the PyPI project must allow the ferstar/ace-wrapper repository and the pypi GitHub environment.