Submit an agent
Build something useful for teams running Habitats? Publish it to the marketplace. Submissions go through a review for safety, cost, and quality, then list with a Community badge. You earn revenue share on every run.
About your agent
Tell us what it does, who it's for, and what it costs to run. We'll use this for the listing card.
How it runs
Habitats agents run as managed sandboxes with declared tools, declared cost, and a manifest. Point us at your repo or upload a manifest.
habitat.yaml at the root · public repo or token-sharedAbout you
Who's behind this agent. We list publishers on the agent detail page so users know who they're trusting.
SDK documentation
A short tour of the Habitats agent SDK. Full reference lives at builders@thefocus.ai while the public docs site is in flight.
Install
npx habitats@latest init my-agent cd my-agent && npm install
Define an agent
Every agent exports a manifest (capabilities, cost ceiling, integrations it touches) and a run handler.
import { defineAgent } from "@habitats/sdk";
export default defineAgent({
name: "Email Marketing",
description: "Drafts campaign calendars from a brief.",
costCeiling: { perRun: "$5.00" },
integrations: ["mailchimp", "sendgrid"],
async run({ input, tools, log }) {
const audience = await tools.mailchimp.listSegments();
const draft = await tools.llm.generate({ /* prompt */ });
log.artifact("Q3 Calendar", draft);
return draft;
},
});
Run locally
habitats run --input ./fixtures/brief.md # streams logs, costs, and artifacts to your terminal
Submit for review
habitats submit # uploads manifest + demo to the review queue
After your first 1,000 successful runs and a clean security review, your agent becomes eligible for the Verified by TheFocus.AI tier — the badge users look for in the marketplace.