title: "Quick Start Guide"
Welcome to OpenCodeHub! This guide will help you get started in minutes.
1. Login
Navigate to your instance URL (e.g., http://localhost:4321) and log in with the admin credentials you created during installation.
2. Create a Repository
- Click the + icon in the top navigation bar
- Select New Repository
- Enter a name (e.g.,
my-project) - Choose visibility: Public or Private
- Optionally initialize with a README
- Click Create Repository
3. Push Code
# Clone your new repository
git clone https://git.yourcompany.com/your-username/my-project.git
cd my-project
# Add your code
echo "# My Project" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main
Or use SSH:
git clone ssh://git@your-server:2222/your-username/my-project.git
4. Explore the Dashboard
Your dashboard shows:
- Recent Repositories you've worked on
- Pull Requests requiring your attention
- Stacked PRs if you're using the stack workflow
- Activity Feed from your team
5. Create a Pull Request
- Navigate to your repository
- Click Pull Requests → New Pull Request
- Select source and target branches
- Add a title and description
- Click Create Pull Request
See First Repository for a complete walkthrough.
6. Try Key Features
Stacked PRs
Break large changes into reviewable stacks:
# Install the CLI
npm install -g opencodehub-cli
# Login
och auth login
# Create a stacked branch
och stack create feature/part-1
# Make changes, commit, push
och stack submit
AI Code Review
Enable in Settings → AI Review. Configure your preferred provider (OpenAI, Anthropic, etc.) and AI will automatically review PRs for bugs and security issues.
Merge Queue
Add PRs to the merge queue from the PR page. The queue ensures main never breaks by running CI on the merged result before pushing.
CI/CD Pipelines
Create .github/workflows/*.yml files in your repository. OpenCodeHub uses GitHub Actions-compatible syntax.
7. Install the CLI
npm install -g opencodehub-cli
# Authenticate
och auth login --url https://git.yourcompany.com
# Check status
och status
See CLI Overview for all commands.
Next Steps
- First Repository — Complete repository lifecycle
- Stacked PRs — Learn the stack workflow
- CLI Reference — All CLI commands
- Configuration — Customize your instance