Repository navigation
This release adds an agent skill: a folder of instructions that teaches an AI coding agent to use Veil. The Python package itself is unchanged from 0.1.0.
Why
An agent that opens a document has already sent it to its model. The skill teaches the agent a different order: run Veil on the file by path, read only the anonymized copy, and restore the originals into an output file it does not read back.
What's new
skills/veil/— an Agent Skill in plain Markdown plus one Python script. It works with any model and any runtime that can read files and run a shell command.SKILL.md: the workflow, option tables and rules for handling tokens.scripts/veil_tool.py: a file-based helper withcheck,anonymize,scan,reconstructandsessioncommands. It prints counts, types, offsets and scores, never the original values. Session files are written owner-only (0600), and it exits with code 2 and writes nothing if a detector cannot load.references/: the CLI, profiles and custom patterns, the Python API, the LLM proxy and the HTTP API.
docs/agent-skill/— documentation for the skill: installation, workflow, helper script reference, choosing options, and troubleshooting.tests/test_skill.py— checks that the helper's output never contains an original value.
Use it
pip install "git+https://github.com/SpinettaInc/veil.git@v0.2.0"
python -m spacy download en_core_web_sm
git clone --branch v0.2.0 https://github.com/SpinettaInc/veil.git
ln -s "$PWD/veil/skills/veil" ~/.claude/skills/veil # or your agent's skills directory
python veil/skills/veil/scripts/veil_tool.py check
python veil/skills/veil/scripts/veil_tool.py anonymize notes.txt \
--out work/notes.anon.txt --session work/session.json
python veil/skills/veil/scripts/veil_tool.py reconstruct work/reply.md \
--out reply.md --session work/session.jsonThe skill folder is not part of the installed package, so it comes from a checkout of the repository.
Notes
- The package version reported by
veil versionis still0.1.0: no code undersrc/changed in this release. - The skill is a set of instructions. It cannot stop an agent that ignores it from opening the original file, and no detector finds every sensitive value.
- Veil remains alpha software, licensed under GPLv3.
Full changelog: v0.1.0...v0.2.0