Concepts
Product
A repository agents work on. The parent of every Story.
A Product is a repository you want agents to work on. It has a
required repository_url, a slug, a human-readable title, and an
optional icon and default branch. Every Story belongs to exactly one
Product; every Cronjob fires Stories against exactly one Product.
What "Product" implies
Some downstream behavior depends on the Product:
- Workdir. When the daemon claims a task, it clones the Product's
repository_urlinto an isolated per-Story workdir. The clone uses the systemghorGITHUB_TOKENfor auth, scoped to the daemon host. Evoxiv never sees your code. - Branch. The clone is
--depth 1 --branch <default_branch>(or the repo's HEAD default if unset). - Agent pairing. Agents can be paired with specific Products via the Products checkbox group on the Agent editor. An Agent with no pairings is treated as paired with every Product in the Workspace (now and in the future). The pairing controls which Agents are visible as dispatch targets for that Product, and which Agents the daemon will auto-claim unassigned Stories on its behalf.
- Story numbering. Stories carry a Product-local number rendered
as
<product-slug>-<n>. This is what shows up in the sidebar and the URL.
Status
A Product can be active (the default) or archived. Archiving stops
new Stories and Cronjobs from targeting it and drops it from the count
that the workspace's products limit checks against. Existing Stories
and run history are preserved.
Plan caps
- Free: 1 Product.
- Pro: unlimited.
- Scale: unlimited.