GitHub Setup_

Version control and off-site backup. Your agent can push, pull, and manage repositories. Essential for projects you want to evolve over time.

What It Does

GitHub lets your agent:

• Create and manage repositories
• Push code and project files with commit messages
• Pull existing repos into your workspace
• Maintain version history and branching
• Keep a permanent backup of your work

Installation Steps

1. Create a GitHub Account (if needed)

Visit github.com and create a free account. You can have unlimited private repositories.

2. Generate a Personal Access Token

Go to github.com/settings/tokens and create a new token with these permissions:

• repo (full control of private repositories)
• workflow (manage GitHub Actions if you want automation)

Copy the token—you'll only see it once.

3. Store the Token in .env

Add this to your workspace .env:

4. Test the Connection

Ask your agent to test the setup:

Check that the repo appears in your GitHub account within a minute.

Best Practices

• Keep repos private: Set each repo to private unless you want it public.
• Use clear commit messages: Ask your agent to write descriptive commits (e.g., "feat: add user authentication").
• Backup regularly: Push important work at milestones, not just once.
• One token per purpose: Create separate tokens for different tools if needed.

Verification

Successful setup means:

• Your agent can create repos under your account
• Commits appear with proper messages
• You can pull the repo to another machine

Troubleshooting

• Token expired or invalid: Regenerate a new token and update .env.
• Push rejected: Check branch protection rules or repo permissions.
• Authentication failed: Ensure the token has the repo scope.