Projects
A project lists the skills and prompts one codebase needs and the people who work on it. Admins create and archive projects.
A project belongs to an organisation. It lists the skills and prompts one codebase should have, and who works on it. Tie a repository to a project with deftro init, and deftro sync installs what the project lists.
Create a project
Owners and admins can create projects.
- Open Projects.
- Select New project under the organisation.
- Enter a Name. A Slug is suggested; it is permanent, because install commands and
deftrocarry it. Add a description if you like. - Select Create project.
Add artifacts
On the project page, Add skill uploads a new one straight into the project. To add an existing one, use Scoped skills & prompts: choose an artifact of the organisation and select Attach. Anyone who can publish in the organisation can attach. Organisation-wide artifacts show here too, marked Organisation-wide.
Detach removes an artifact from the project; it needs an admin or the project lead.
Project members
The project's members list shows who is assigned. An admin or the project lead can add an organisation member, raise the role they hold on this project, or select Make lead. See Roles and permissions.
Project settings
Select Project settings on the project page. An admin or the project lead can rename it, change its description, and, if the organisation allows it, turn on Skip review for this project. Versions published while that is on are permanently marked unreviewed. You can also start Import from GitHub here.
Archiving
Admins can select Archive in Project settings. An archived project keeps what is attached and still installs, but accepts no new artifacts, versions or invitations. Unarchive opens it again. Use Show archived projects on the Projects page to find it.
This project is archived
Code: archived
You tried to push Context into a space that belongs to an archived project. Its Context is read-only until the project is unarchived. Ask an admin to unarchive it, or push to another space.
Checked against the product on .
Roles and permissions
Members are owners, admins, editors or viewers; someone invited to one project is a guest. Project and team roles can raise what someone can do, never lower it.Move Baton context between machines
deftro context push uploads Baton memory, plans and handoffs; pull restores them without overwriting your edits.Use the deftro command-line tool
Run deftro with npx to sign in, install pinned skill versions into your agent's folders, keep them in sync, and publish your own.