Setup guide

A clear path to your first workflow.

Start on your desktop, connect a repository server, or build an integration. Each path uses the same StarGit workspace.

Managed hosting

Create on StarGit, then clone with HTTPS or SSH.

Choose your hosting destination, name the repository, and start empty or with a README. Your account is selected automatically.

Agents use a hosting token with explicit repository creation permission. HTTPS push permission is separate. Keep changes on branches and use pull requests for human review.

01 / Desktop

Start with a repository.

  1. Choose your build. Open Downloads and select the operating system and package you need.
  2. Install and sign in. Follow the installation tutorial. Account and activation details are available on the account & license page.
  3. Review your first changes. Open a repository and follow Everyday Git for branches, commits, and synchronization.

02 / Workspace

See the work across your servers.

Sign in to see the dashboard, connected repositories, and recent activity. Start with a connected server before trying remote Git operations.

Repositories

Inspect branches, changes, and commit history in the context of the server that owns each repository.

Team work

Organize tasks with Kanban boards and use discussions to keep decisions close to the work.

Execution

Follow queued operations through to their result. An accepted request is only the beginning of an operation.

03 / StarBridge

Connect the server that holds your code.

StarBridge runs on your infrastructure. It receives work from StarGit, performs Git operations locally, and returns status and results.

  1. Create a StarGit API key. Sign in and open API keys. Keep the key private.
  2. Install StarBridge on the repository host. Follow the installation and environment setup in the StarBridge source repository .
  3. Link StarBridge to StarGit. Set STARGIT_API_URL to your StarGit address and STARGIT_API_KEY to the key from your account. The separate STARBRIDGE_API_KEY protects the local StarBridge API.
  4. Verify the connection. Start StarBridge, then open Servers in your workspace. Check its heartbeat and repository information before running an operation.

04 / Automation

Build on a visible execution loop.

1. Configure the action

Use workspace workflows, runners, and webhook settings to define the job and its target repository.

2. Execute on the host

StarBridge receives queued work. The server must be connected and able to access the repository.

3. Check the result

Inspect queue state and logs. Resolve errors before depending on subsequent steps.

Building an integration? The API reference distinguishes API-key access, server tokens, and signed-in workspace operations.

05 / AI assistance

Configure assistance for your workflow.

StarGit includes commit and diff assistance, agent conversations, and scheduled agent jobs. Availability depends on the feature and provider setup.

Web agent chat and schedule automation use the OpenAI API key saved to your account. Review your provider configuration before sending repository context to an AI service.

Review AI provider access

Need a hand with setup?

Find answers to common questions or send the team a request.

Cookie preferences

Cookies keep you signed in and maintain your session. Your choice here is remembered for one year.

Essential session cookies may still be needed when you sign in. See the privacy policy for details about data handling.