Servers & projects
Who owns the machine, who can see a project, and how the three Nethür layers fit together.
Nethür has three layers. Keeping them separate explains most of the product:
- Server — a machine running the Nethür runtime. It owns accounts, projects, members and agents.
- Project — a git repository or folder on that server.
- Workspace — one isolated checkout of a project: a git worktree or a folder workspace, with its own tabs and agent sessions.
Servers
A server is created and managed under Settings → Servers. It can be:
- Personal — only you. It lives on your desktop, or on a VPS you own.
- Team — shared with members. Projects, sessions and team chat are visible to the team according to their roles.
Each server has its own provider accounts. Connecting Claude or Codex on one server does not connect it on another. This is intentional: an account belongs to the machine that runs the agent.
The server also owns its data directory: projects, workspaces, chats, usage history, notes and contents. Back up that directory if the data matters.
Members and roles
Team members are invited from the server settings. The roles are:
| Role | Can do |
|---|---|
| Owner | Everything, including billing, members and deleting the server. |
| Admin | Manage projects, members and most settings; cannot delete the owner. |
| Member | Work in projects they can see, use agents, chat and open workspaces. |
Removing a member also revokes their pairing/devices and closes their open connections. Their work remains in the server's projects.
Project visibility is separate from server membership. A server member can technically reach every project; a project removed from a member's list disappears from their sidebar, notes and contents. Treat project visibility as organisation, not as a hard security boundary.
Projects
Add a project with Add repo on the sidebar. Nethür accepts:
- a git repository (with a remote or a local path),
- a folder workspace that does not need git.
For a git project, Nethür reads the current branch and uses it as the base ref for new workspaces. You can change the base ref later in the project settings.
Projects can be shared with the whole server or kept to a subset of members. The same project can be opened from the browser, the desktop app and the phone; the server is the source of truth.
Accounts are per server
AI provider accounts — Claude, Codex, OpenCode and others — are connected under Settings → Accounts for the selected server. Each teammate can add their own account. Nethür tracks usage per account and can move a chat to another account or provider when a limit is reached.