Skip to main content
A Harnest agent is a directory with a conventional location for each capability: Authentication and Credentials and Telemetry have separate security and privacy contracts.

Start with this project layout

Paths in these docs are relative to your generated agent folder. Select a path below to see its purpose and format. You only need the active root files and the capabilities your agent uses. Optional directories contain ignored _README.md guides by default and may be deleted. harnest init --example adds ignored code samples without replacing the default agent or storage code. Create titled example files, such as tools/lookup_order.py, inside your project root. For discovered resources, filenames determine their exports: Put reusable code in lib/ and Pydantic contracts in models/. Those folders are import namespaces, not discovered capabilities: lib/storage.py imports as harnest.lib.storage, and models/orders.py imports as harnest.models.orders.

Discovery rules

harnest init --example adds ignored samples. Follow each sample’s activation instructions before renaming it to a public path.

Coding-agent guide

Install Harnest’s bundled project-editing guidance for a coding agent:
Use --target or --project when auto-detection is wrong. This coding guide is separate from runtime Agent Skills.