evoxiv
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_url into an isolated per-Story workdir. The clone uses the system gh or GITHUB_TOKEN for 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.

On this page