Skip to content
Niuniu
中

Core concepts

Project / Repository / Workspace / Agent / Owner / Org — the six concepts.

niuniu organizes everything around six core concepts. Once you understand these six, the whole product makes sense.

Owner

Every top-level resource has an owner — either a user (personal space) or an org (organization space). This is the foundation of multi-tenancy: user A cannot see user B’s resources; org A cannot see org B’s resources.

User & Org

  • User: a registered account. Every user automatically gets a personal space.
  • Org: an organization. A user can belong to multiple orgs; each org has three roles: owner / admin / member.

Repository

Represents a git repository — either a local path or a git URL. Once registered with niuniu, niuniu manages its worktrees and branch metadata.

Project

A Project is a Kanban board containing Issues, Columns, Checklists, and Comments. A Project can have zero or more Repositories attached to it.

Workspace

The central concept. A workspace = the execution environment for one issue:

  • Tied to one issue (a task inside a project)
  • Automatically creates an isolated git worktree for each attached repository
  • Has its own shell environment, agent session, and file tree

Workspaces are fully isolated from each other — code changes in workspace A don’t bleed into workspace B.

Agent

An agent is the Claude Code instance running inside a workspace. niuniu offers two integration paths:

  • PTY terminal: spawns the claude CLI as a child process and bridges its I/O to the browser over a pseudo-terminal
  • Structured agent: drives the claude CLI as a structured chat session, persisting messages, cost, and session state to the database

Relationship diagram

User / Org (Owner)
  └─ Project
       ├─ Issue
       │    └─ Workspace
       │         ├─ Worktree (per repo)
       │         └─ Agent
       └─ Repository (attached)

Next steps

Edit this page on GitHub →