Set up a project
Connect a new or existing repository to Integrity.
1. Open your project
- Complete Installation.
- Open your project's repository in Codex.
- Use the same setup request for a new or existing project:
Set up Integrity for this project.
2. Answer the setup questions
- New project: describe who it is for, what you want to build first, and any constraints.
- Existing project: the agent reads your code, tests, and instructions before suggesting changes.
- Choose the Integrity workspace and Team for this project.
- Confirm the proposed setup when the agent asks.
3. Review and save
The agent shows the proposed changes before you approve them:
- Project context in
.integrity/project.md: the project's purpose, workspace, and default Team. - Project guidance in
.integrity/concerns.yaml: links to the instructions the agent should follow. - Existing repository instructions stay in place. Ask for corrections if the proposed context is wrong.
When you're happy with the changes, ask the agent:
I approve this project setup. Commit the changes.
How code changes reach your project
- During setup, review which branch receives completed work and whether a pull request is required.
- Coding tasks work in separate Git worktrees so they do not overwrite your everyday checkout.
- The agent checks and commits its changes, then integrates them according to your repository settings.
- Required reviews still apply. Updating the remote branch may run your existing CI or deployment automation.
- If checks or integration fail, the agent preserves the work and explains what needs attention.
Next step
Continue to Build your first feature.