# Workspace Manager for .NET (in development)

Source: https://libtmux.org/en/dotnet/latest/workspace/

> Install the prerelease .NET tmux-workspace CLI from NuGet; implementation coverage remains partial.

**Workspace Manager for .NET is in development.** The `tmux-workspace` CLI is published to NuGet as a prerelease. Its command and configuration coverage is partial.



Native services load/reuse/append and capture sessions, discover and search
documents, convert formats, import configurations and run editors. A checked
Python bridge provides Python-specific shell and workspace-extension behavior.

## Load a workspace from the terminal

Install `tmux-workspace` from NuGet with any method under
[Install](#install). The [installation walkthrough](./guides/installation/)
loads a small workspace on a private socket. Inspect the command without
starting tmux:

```console
$ tmux-workspace --help
```

Use detached load for the walkthrough. JSON and NDJSON output are available;
choose the mode explicitly when scripting. The command/configuration reference
below also documents tmuxp behavior and compatibility targets, so it is not a
claim that every referenced feature works in this implementation.

## Current coverage

Native [imports](./cli/import/#native-net-imports) preserve supported command
groups, directories, Teamocil options/focus and synchronization timing. They
validate the translated workspace before printing or saving it and refuse
unsupported lifecycle fields. Load creates panes in configuration order;
[pane configuration](./configuration/panes/) explains indexes and focus.

Native `--log-level` filters optional diagnostics. On Linux x64,
`load --log-file` appends structured logs; see the
[output reference](./reference/output/) for destination and failure handling.

On Linux x64, human load shows terminal progress on stderr, with presets,
literal token templates and bounded script output. See
[load](./cli/load/#progress-and-script-output) for counters, stream handling
and resize limits.

Native append retains the current pane's resolved session across all inputs,
even if a script moves the pane. Later commands reject a replacement daemon.
Append with Python plugins or custom builders is unavailable and fails before
building any input or starting Python; use `-d` for those extensions.

Human load supports attachment and client-selection prompts from a foreground
controlling terminal on Linux x64. It authenticates the invoking pane and
selected daemon before building, then checks the client again before handoff.
See [native attachment](./cli/load/#native-net-attachment) for choices and
interruption behavior.

Attached Python extension handoff, broader extension lifecycle validation,
contextual completion, and the full configuration and platform corpus remain
unfinished.

For the released Python workflow, use [tmuxp](https://tmuxp.git-pull.com/)
and its [Python workspace guide](/py/latest/workspace/guides/). It is a separate
application and remains useful when a required native feature is incomplete.

## Start here

The `LibTmux.Workspace` library package remains available for applications that
build sessions through code. [Internals](./internals/) documents that API:

- [Guides](./internals/guides/) show application setup and builder calls.
- [Topics](./internals/topics/) explain supported configuration and behavior.
- [Examples](./internals/examples/) exercise the library or source consumer.
- [API](./reference/) covers the builder and configuration interfaces.

## tmuxp command and configuration reference

Use the CLI's help and the limits above when applying these compatibility
references to native execution.

- [Installation walkthrough](./guides/installation/) installs and runs the published native CLI.
- [Inspect through MCP](./guides/inspect-with-mcp/) connects to the loaded session.
- [Command reference](./cli/) lists tmuxp commands, flags and compatibility targets.
- [Configuration](./configuration/) covers fields, normalization and execution.
- [Example gallery](./examples/gallery/) includes upstream fixtures and prerequisites.
- [Compatibility status](./reference/compatibility/) records builder/reference gaps.
- [JSON, NDJSON, and color](./reference/output/) describes the shared output design.