Skip to content
Niuniu
中

Workspace & agent chat

Create workspace, PTY vs proxy paths, message history, cost tracking.

The workspace is where you collaborate with Claude Code. niuniu offers two agent integration paths — choose based on your workflow.

Launch a workspace

The most common path is launching from an issue (see the Kanban guide). You can also go directly to the Workspaces tab and click + New. When creating a workspace you can optionally link it to an issue and choose which repositories to attach.

PTY terminal mode

Workspace → Terminal tab. This is a real terminal running the claude CLI — identical to running claude locally:

  • Supports colored output and ANSI control sequences
  • You can type any command directly in the terminal (git, ls, test runners, etc.)
  • niuniu bridges the character stream to the browser over WebSocket
  • Terminal history is not persisted (it clears when the agent restarts)

Best for: free-form exploration and debugging sessions that need real-time interactivity.

Structured agent mode

Workspace → Chat tab. This is niuniu’s own chat panel:

  • Every message (your prompt and Claude’s reply) is persisted to the database
  • Token cost is tracked automatically; view the usage curve in the Workspace → Cost tab
  • Supports copying individual messages, quoting replies, and @-mentioning files
  • History survives browser refreshes, shutdowns, and restarts

Best for: long-running workflows, audit trails of discussions, and cross-device access.

Switching between modes

The two paths share workspace state — files, worktrees, and git history are identical in both; only the agent interface differs. You can freely mix both modes in the same workspace.

File tree and diff

The Files sidebar shows the full workspace file tree. Diff shows the current git changes compared to the base branch.

Next steps

Edit this page on GitHub →