Skip to content
Niuniu
中

5-minute quickstart

Download, launch, create your first workspace, run an agent.

This guide uses the Personal desktop edition to walk you through the full flow in about five minutes.

1. Download

Go to GitHub Releases and download the package for your platform:

  • macOS: niuniu-personal-<version>-darwin-arm64 (Apple Silicon) or niuniu-personal-<version>-darwin-amd64 (Intel)
  • Windows: niuniu-personal-<version>-windows-amd64.exe
  • Linux: niuniu-personal-<version>-linux-amd64

<version> is the release tag, e.g. v1.0.7. Double-click to launch; on first run you’ll be prompted for a few basic settings (data directory, whether to enable auth) — the defaults are fine.

2. Log in

Default credentials:

  • Username: niuniu
  • Password: niuniu123

After logging in you’ll land in the console with three main tabs: Workspaces / Projects / Repositories.

3. Add a repository

Switch to the Repositories tab, click + New, and enter a local path or git URL. niuniu will automatically detect the branches and default branch.

4. Create a project and add an issue

Switch to Projects, click + New Project, attach the repository you just added, then inside the project click + New Issue in the default column and write a one-line description of what you want done.

5. Launch a workspace from the issue

In the issue detail sidebar click Create Workspace. niuniu will automatically:

  • Create a new git worktree (based on the default branch)
  • Place a .mcp.json in the workspace directory (so Claude Code can read project state)
  • Navigate you to the workspace detail page

6. Start the agent

On the workspace detail page click Start Agent, then start chatting in the left-hand chat panel. Try this as your first message:

Please look at this repository's README and summarize what the project does.

Claude will invoke the claude CLI through a PTY terminal, read the project files, and reply.

Next steps

Edit this page on GitHub →