Repositories

In OutcomeDev, a Repository (or "Repo") is the home for your project.

What is a Repository?

If you are new to software development, think of a Repository as a project folder that lives in the cloud. It contains:

1. All your files: Code, images, documents.
2. History: A record of every change ever made (Version Control).
3. Collaboration: Tools for people to work together without overwriting each other's work.

We use GitHub, the world's most popular platform for hosting repositories.

Creating a Repository

To start a new project, you need a repository.

1. Click the "+" Icon: Located in the top header or the "New Repo" option in the menu.
2. Owner: Select who will own this repo (usually your personal account).
3. Name: Give it a unique name (e.g., marketing-dashboard, 3d-house-plans).
4. Privacy:
   • Public: Anyone can see it. Good for open-source.
   • Private: Only you can see it. Good for internal tools.
5. Description: A short sentence about what this project is.

Once created, OutcomeDev automatically connects to it. You are ready to start assigning tasks.

The Repository Workspace

When you select a repository from the sidebar, you enter the Repository Workspace. This area provides a specialized view of your project's current state on GitHub:

• Commits: A chronological list of every change made to the codebase. You can see who made the change and read the commit messages.
• Issues: Track bugs, feature requests, and tasks. You can view existing GitHub Issues or create new ones directly from this view.
• Pull Requests: See all active proposals to merge code. This is where you (or the agent) submit work for final review.
• New Task: Quickly start a new task for the specific repository by clicking the "+" icon next to the tabs.

Why Version Control Matters

OutcomeDev uses Git under the hood. This provides safety:

• Undo Button: Every change the agent makes is saved as a "Commit." If the agent breaks something, you can revert to the previous version.
• Branches: Agents work on "Branches" (separate timelines). They don't touch your main code until you approve it.
• Pull Requests (PRs): This is a proposal to merge the agent's work into your main project. You can review the changes, see the "Diff" (difference), and approve or reject it.

Importing Existing Repos

Have a project already on GitHub?

1. Click the Repo Selector in the header.
2. Search for your repository name.
3. Select it to start creating tasks for that existing codebase.