NPIAC
Turns a local repo into a compact deterministic CONTEXT.md briefing for coding agents.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Python>=3.11
Clone NPIAC source for pip install
git clone https://github.com/dRafaleD/NPIAC.git /tmp/NPIACInstall NPIAC with pip from source
cd /tmp/NPIAC && python3 -m pip install .
Check that it works
npiac --helpThe output should contain “usage: npiac”.
First thing to try
mkdir -p /tmp/sample-api/src/sample && cat > /tmp/sample-api/pyproject.toml <<'EOF'
[project]
name = "sample-api"
version = "0.1.0"
dependencies = ["fastapi", "uvicorn"]
[project.scripts]
sample-api = "sample.main:main"
EOF
cat > /tmp/sample-api/src/sample/main.py <<'EOF'
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"hello": "world"}
def main():
import uvicorn
uvicorn.run(app)
EOF
cat > /tmp/sample-api/requirements.txt <<'EOF'
fastapi
uvicorn
EOF
ls -R /tmp/sample-apinpiac /tmp/sample-api --stdoutRun npiac <repo-path> --stdout to print a context briefing for a repository.
What it does
- Generate a context briefing for a repositoryTested
How to use it
- Run
npiac <repo-path> --stdoutto print the Markdown briefing. - Read the output, which starts with "# Repository Context".
- Run
- Detect languages, frameworks, and entry pointsNot shown working
- Add architecture notes using local OllamaNot tested
- Limit context size with a budgetNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- Generate deterministic context in the current repository
- Print repository context Markdown without writing a file
- Limit final context size with a character budget
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.6.0