nuspace 0.6.0__tar.gz → 0.6.2__tar.gz

{nuspace-0.6.0 → nuspace-0.6.2}/CHANGELOG.md

@@ -2,13 +2,31 @@
 
 ## Packages shipped from this repo
 
-- **nuspace** (the runtime, the `nuspace` command) — 0.6.0
-- **nuspace-ui** (the compiled web bundle) — 0.5.7
+- **nuspace** (the runtime, the `nuspace` command) — 0.6.2
+- **nuspace-ui** (the compiled web bundle) — 0.5.8
 
 Below is the changelog for **nuspace** - the full commit stream. Newest first.
 The `nuspace-ui` wheel is the same source tree's vite output and is not tracked
 separately here.
 
+## 0.6.2 — 2026-10-30
+
+- Release nuspace 0.6.2 on nu 0.6.8 and nuverse 0.3.5
+- Trim the README description to what nuspace is, dropping the example list
+- Keep space data in .nuspace and find spaces like git, with a home default
+- Export usage tracking from ops so planes can count first-run steps
+- Package planes get their own id and reopen the same plane across runs
+- Bare plane names default to nuverse, so first runs need no package name
+- Restructure telemetry tracking
+- Edit README and summary to match the new identity lines
+
+## 0.6.1 — 2026-10-27
+
+- Release nuspace 0.6.1, built on nuspace-ui 0.5.8 and ui-kit 0.3.6
+- Update sidebar and seed tests for the new rail layout
+- Restructure the sidebar into nav rows, pinned, planes and extensions, one keyboard stop
+- Pick plane icons from the whole lucide set, loaded on demand
+
 ## 0.6.0 — 2026-10-26
 
 - Release nuspace 0.6.0, built on nuspace-ui 0.5.7 and nu 0.6.7

{nuspace-0.6.0 → nuspace-0.6.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: nuspace
-Version: 0.6.0
-Summary: Computational space for everything you work with: notes, data, tools, agents.
+Version: 0.6.2
+Summary: Computational space for your data and tools.
 Project-URL: Repository, https://github.com/nustackdev/nuspace
 Author-email: Gor Arakelyan <gorarkln@gmail.com>
 License-Expression: AGPL-3.0-or-later
@@ -15,11 +15,12 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
+Requires-Dist: certifi>=2023.7.22
 Requires-Dist: click>=8.0
-Requires-Dist: nucore>=0.6.7
-Requires-Dist: nuspace-ui>=0.5.7
-Requires-Dist: nustd[kv,mp-pool,proxy,ui,valkey]>=0.6.7
-Requires-Dist: nuverse>=0.3.4
+Requires-Dist: nucore>=0.6.8
+Requires-Dist: nuspace-ui>=0.5.8
+Requires-Dist: nustd[kv,mp-pool,proxy,ui,valkey]>=0.6.8
+Requires-Dist: nuverse>=0.3.5
 Requires-Dist: rich-click>=1.6
 Requires-Dist: rich>=10.7
 Requires-Dist: typing-extensions>=4.7.0
@@ -31,7 +32,8 @@ Description-Content-Type: text/markdown
 <div align="center">
   <img width="112" alt="nuspace" src="https://nustack.dev/brand/logo-square-512@2x.png" />
   <h1>nuspace</h1>
-  <p>Computational space for everything you work with: notes, data, tools, agents.</p>
+  <p>Computational space for your data and tools. Human-first. Agent-native.</p>
+  <p><sub>Open-source · Self-hosted · Pure Python</sub></p>
   
   [![Python](https://img.shields.io/badge/python-%3E%3D%203.10-blue)](https://pypi.org/project/nuspace/)
   [![PyPI](https://img.shields.io/pypi/v/nuspace?color=yellow)](https://pypi.org/project/nuspace/)
@@ -44,7 +46,7 @@ Description-Content-Type: text/markdown
 </div>
 
 
-Elsewhere, a note is a dead document, data is scattered, tools are siloed and an agent's work is lost in chat. In nuspace, they're all connected cells: living programs that hold data, logic and look in one form.
+In nuspace, your data and tools live in cells: tiny reactive programs that manage data, run logic and render UI. Cells are written in nu, a Python programming model with no glue code between layers, so a cell is a few lines, not a thousand. Humans get the space as UI, agents get it as code.
 
 **nuspace in action:**
 
@@ -186,10 +188,11 @@ Install from PyPI and run a space yourself. Python 3.10 or newer.
 2. **Run**
 
    ```bash
-   nuspace run my.nuspace
+   nuspace run
    ```
 
-   A browser opens on your space.
+   A browser opens on your space: the nearest one up from here, else your home space.
+   `nuspace init` makes the current directory a space of its own, data in `.nuspace/`.
 
 3. **Try a demo**
 
@@ -198,7 +201,7 @@ Install from PyPI and run a space yourself. Python 3.10 or newer.
    nuspace run --with nudemos.movies
    ```
 
-   A throwaway space with a full app in it.
+   A full app in your space. Add `--tmp` for a throwaway space instead.
 
 </details>
 
@@ -300,8 +303,8 @@ Any agent that reads skills learns nu and nuspace from them, installs nuspace an
 | 01 | <code>the theory</code> <br/> [**interaction-model**](https://github.com/nustackdev/interaction-model) | A programming model where every resource is a Ref and Interactions are first-class, so you compose logic across systems. |
 | 02 | <code>the primitive</code> <br/> [**nu**](https://github.com/nustackdev/nu) | The interaction model, implemented in Python. |
 | 03 | <code>the std library</code> <br/> [**nustd**](https://github.com/nustackdev/nu/tree/main/pkgs/nustd) | Batteries for nu: storage, UI, workers and more, ready to use. |
-| 04 | <code>the space</code> <br/> [**nuspace**](https://github.com/nustackdev/nuspace) | A space that runs nu programs. Every cell is one. |
-| 05 | <code>the ecosystem</code> <br/> [**nuverse**](https://github.com/nustackdev/nuverse) | Ready-made spaces and extensions, one install away. |
+| 04 | <code>the space</code> <br/> [**nuspace**](https://github.com/nustackdev/nuspace) | A space that runs nu programs. |
+| 05 | <code>the ecosystem</code> <br/> [**nuverse**](https://github.com/nustackdev/nuverse) | Ready-made packages, one install away. |
 | + | **your space**, on top of it all | Everything below exists so your space can be anything. |
 
 ## Community

{nuspace-0.6.0 → nuspace-0.6.2}/README.md

@@ -1,7 +1,8 @@
 <div align="center">
   <img width="112" alt="nuspace" src="https://nustack.dev/brand/logo-square-512@2x.png" />
   <h1>nuspace</h1>
-  <p>Computational space for everything you work with: notes, data, tools, agents.</p>
+  <p>Computational space for your data and tools. Human-first. Agent-native.</p>
+  <p><sub>Open-source · Self-hosted · Pure Python</sub></p>
   
   [![Python](https://img.shields.io/badge/python-%3E%3D%203.10-blue)](https://pypi.org/project/nuspace/)
   [![PyPI](https://img.shields.io/pypi/v/nuspace?color=yellow)](https://pypi.org/project/nuspace/)
@@ -14,7 +15,7 @@
 </div>
 
 
-Elsewhere, a note is a dead document, data is scattered, tools are siloed and an agent's work is lost in chat. In nuspace, they're all connected cells: living programs that hold data, logic and look in one form.
+In nuspace, your data and tools live in cells: tiny reactive programs that manage data, run logic and render UI. Cells are written in nu, a Python programming model with no glue code between layers, so a cell is a few lines, not a thousand. Humans get the space as UI, agents get it as code.
 
 **nuspace in action:**
 
@@ -156,10 +157,11 @@ Install from PyPI and run a space yourself. Python 3.10 or newer.
 2. **Run**
 
    ```bash
-   nuspace run my.nuspace
+   nuspace run
    ```
 
-   A browser opens on your space.
+   A browser opens on your space: the nearest one up from here, else your home space.
+   `nuspace init` makes the current directory a space of its own, data in `.nuspace/`.
 
 3. **Try a demo**
 
@@ -168,7 +170,7 @@ Install from PyPI and run a space yourself. Python 3.10 or newer.
    nuspace run --with nudemos.movies
    ```
 
-   A throwaway space with a full app in it.
+   A full app in your space. Add `--tmp` for a throwaway space instead.
 
 </details>
 
@@ -270,8 +272,8 @@ Any agent that reads skills learns nu and nuspace from them, installs nuspace an
 | 01 | <code>the theory</code> <br/> [**interaction-model**](https://github.com/nustackdev/interaction-model) | A programming model where every resource is a Ref and Interactions are first-class, so you compose logic across systems. |
 | 02 | <code>the primitive</code> <br/> [**nu**](https://github.com/nustackdev/nu) | The interaction model, implemented in Python. |
 | 03 | <code>the std library</code> <br/> [**nustd**](https://github.com/nustackdev/nu/tree/main/pkgs/nustd) | Batteries for nu: storage, UI, workers and more, ready to use. |
-| 04 | <code>the space</code> <br/> [**nuspace**](https://github.com/nustackdev/nuspace) | A space that runs nu programs. Every cell is one. |
-| 05 | <code>the ecosystem</code> <br/> [**nuverse**](https://github.com/nustackdev/nuverse) | Ready-made spaces and extensions, one install away. |
+| 04 | <code>the space</code> <br/> [**nuspace**](https://github.com/nustackdev/nuspace) | A space that runs nu programs. |
+| 05 | <code>the ecosystem</code> <br/> [**nuverse**](https://github.com/nustackdev/nuverse) | Ready-made packages, one install away. |
 | + | **your space**, on top of it all | Everything below exists so your space can be anything. |
 
 ## Community

{nuspace-0.6.0 → nuspace-0.6.2}/examples/space.py

@@ -2,7 +2,8 @@
 
 Every Plane, Cell and content kind comes from an installed extension, found
 through its entry point.
-The space is the directory ``examples/example.nuspace``, kept between runs.
+The space's root is ``examples/example.nuspace``, its data in ``.nuspace/``
+inside it, kept between runs.
 
 Run it::
 

{nuspace-0.6.0 → nuspace-0.6.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nuspace"
-version = "0.6.0"
-description = "Computational space for everything you work with: notes, data, tools, agents."
+version = "0.6.2"
+description = "Computational space for your data and tools."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
 authors = [{ name = "Gor Arakelyan", email = "gorarkln@gmail.com" }]
@@ -14,21 +14,24 @@ dependencies = [
     # The fabrics a space runs on, nothing more: kv for the store, valkey for
     # its change notifications, ui for the browser, mp_pool for the workers,
     # proxy (invisibles) for the worker's session.
-    "nucore>=0.6.7",
-    "nustd[kv,ui,valkey,mp_pool,proxy]>=0.6.7",
+    "nucore>=0.6.8",
+    "nustd[kv,ui,valkey,mp_pool,proxy]>=0.6.8",
     # The store's change notifications run over virtuals' redis backend.
     "virtuals-py[redis]>=0.1.10",
     # The compiled web bundle. A separate distribution only because PyPI caps
     # project size and a SPA rebuilt on every UI tweak would eat the quota --
     # not optional. `pip install nuspace` gives you the browser.
-    "nuspace-ui>=0.5.7",
+    "nuspace-ui>=0.5.8",
     # The everyday Planes and Cells. A plugin like any other, found through
     # its entry point, but every space ships with it.
-    "nuverse>=0.3.4",
+    "nuverse>=0.3.5",
     "typing-extensions>=4.7.0",
     "click>=8.0",
     "rich>=10.7",
     "rich-click>=1.6",
+    # CA bundle for telemetry's HTTPS POST: python.org macOS builds ship none,
+    # so without it every send fails verification, silently.
+    "certifi>=2023.7.22",
 ]
 keywords = [
     "nu",

{nuspace-0.6.0 → nuspace-0.6.2}/src/nuspace/_cli/_installed.py

@@ -3,7 +3,8 @@
 ``nuspace verse`` lists it and ``nuspace run --with`` picks a Plane out of
 it. A package is its entry point's name, and its Planes are
 ``<package>.<name>``, as a space registers them
-(:func:`~nuspace.ext.qualified`).
+(:func:`~nuspace.ext.qualified`). A bare name is a Plane of
+:data:`DEFAULT_PACKAGE`, the one nuspace ships with.
 """
 
 from __future__ import annotations
@@ -24,7 +25,11 @@ if TYPE_CHECKING:
     from nuspace.ext import Extension, PlaneSpec
 
 
-__all__ = ["Installed", "installed", "resolve"]
+__all__ = ["DEFAULT_PACKAGE", "Installed", "installed", "resolve"]
+
+
+DEFAULT_PACKAGE = "nuverse"
+"""The package a bare plane name is looked up in: ``jobs`` is ``nuverse.jobs``."""
 
 
 @dataclass(frozen=True)
@@ -61,21 +66,38 @@ def installed(group: str = GROUP) -> list[Installed]:
 def resolve(spec: str, packages: list[Installed] | None = None) -> PlaneSpec:
     """``pkg.plane`` as the Plane it names, qualified as a space registers it.
 
+    A bare name, with no dot, is a Plane of :data:`DEFAULT_PACKAGE`.
+
     Raises:
-        click.ClickException: ``spec`` is not ``pkg.plane``, or no installed
-            package adds it.
+        click.ClickException: ``spec`` is not ``pkg.plane`` or a bare name, or
+            no installed package adds it.
     """
     packages = installed() if packages is None else packages
-    pkg, dot, name = spec.partition(".")
+    bare = "." not in spec
+    full = f"{DEFAULT_PACKAGE}.{spec}" if bare else spec
+    pkg, _, name = full.partition(".")
     hits = [
         plane
         for p in packages
         if p.extension is not None and p.name == pkg
         for plane in qualified(p.extension, p.name).planes
-        if plane.name == spec
+        if plane.name == full
     ]
-    if not (pkg and dot and name and hits):
-        raise click.ClickException(
-            f"No plane {spec!r} installed. Name it pkg.plane, see: nuspace verse"
-        )
-    return hits[0]
+    if pkg and name and hits:
+        return hits[0]
+    if bare:
+        raise click.ClickException(_not_in_default(spec, packages))
+    raise click.ClickException(
+        f"No plane {spec!r} installed. Name it pkg.plane, see: nuspace verse"
+    )
+
+
+def _not_in_default(spec: str, packages: list[Installed]) -> str:
+    """Why bare ``spec`` names no Plane: what :data:`DEFAULT_PACKAGE` has instead, if anything."""
+    ext = next((p.extension for p in packages if p.name == DEFAULT_PACKAGE and p.extension), None)
+    head = f"No plane {spec!r} in {DEFAULT_PACKAGE}, where a bare name is looked up."
+    tail = "Name another package's as pkg.plane, see: nuspace verse"
+    if ext is None:
+        return f"{head} {DEFAULT_PACKAGE} is not installed or failed to load. {tail}"
+    names = ", ".join(plane.name for plane in ext.planes) or "none"
+    return f"{head} Its planes: {names}. {tail}"

{nuspace-0.6.0 → nuspace-0.6.2}/src/nuspace/_cli/_meta.py

@@ -1,4 +1,9 @@
-"""What the commands share: the console, the versions, and how a space is held open."""
+"""What the commands share: the console, the versions, which space, and how it is held open.
+
+Which space, the way ``git`` finds a repository: PATH when given, else the
+nearest space at or above the current directory, else the home space (root
+``~``, data in ``~/.nuspace``). ``--tmp`` is a throwaway one instead.
+"""
 
 from __future__ import annotations
 
@@ -14,24 +19,22 @@ from rich.text import Text
 import nu
 from nuspace import _telemetry
 from nuspace._branding import BLUE, header
-from nuspace.system.kernel import NotASpace
-from nuspace.system.usage import Usage
+from nuspace.system.kernel import DATA_DIR, NotASpace, find_space
 
 
 __all__ = [
-    "STORE_ENV",
     "announce",
     "console",
     "hold",
     "opened",
     "path_argument",
+    "space_root",
+    "tilde",
+    "tmp_option",
     "version_of",
 ]
 
 
-#: The environment variable naming the space directory when no path is given.
-STORE_ENV = "NUSPACE_STORE"
-
 console = Console()
 
 _F = TypeVar("_F", bound=Callable[..., Any])
@@ -46,17 +49,37 @@ def version_of(package: str) -> str:
 
 
 def path_argument(fn: _F) -> _F:
-    """The space directory a command takes, from :data:`STORE_ENV` when absent."""
-    return click.argument("path", required=False, envvar=STORE_ENV)(fn)
+    """The space's root a command takes, positional and optional: see :func:`space_root`."""
+    return click.argument("path", required=False)(fn)
+
+
+def tmp_option(fn: _F) -> _F:
+    """``--tmp``: a throwaway space instead of one found, for the commands that open one."""
+    return click.option(
+        "--tmp", is_flag=True, help="A throwaway space in a temp dir, gone at close."
+    )(fn)
+
 
+def space_root(path: str | None, *, tmp: bool = False) -> str | None:
+    """The root of the space a command means, absolute. None with ``tmp``, a throwaway.
 
-def _where(path: str | None) -> str:
-    """The space directory as a person reads it: absolute, home as ``~``."""
-    if path is None:
-        return "throwaway space, gone at close"
+    PATH when given, else the nearest space at or above the current
+    directory, else home.
+    """
+    if tmp:
+        if path is not None:
+            raise click.UsageError("Give PATH or --tmp, not both.")
+        return None
+    if path is not None:
+        return str(Path(path).expanduser().resolve())
+    return str(find_space(Path.cwd()) or Path.home())
+
+
+def tilde(path: str | Path) -> str:
+    """``path`` as a person reads it: absolute, home as ``~``."""
     root = Path(path).expanduser().resolve()
     try:
-        return str(Path("~") / root.relative_to(Path.home()))
+        return str(Path("~") / root.relative_to(Path.home().resolve()))
     except ValueError:
         return str(root)
 
@@ -68,7 +91,13 @@ def announce(path: str | None, *, headless: bool = False, plane: str | None = No
     the header leaves both to it.
     """
     console.print(
-        header("sm", version=version_of("nuspace"), where=_where(path)),
+        header(
+            "sm",
+            version=version_of("nuspace"),
+            where="throwaway space, gone at close"
+            if path is None
+            else f"Path: {tilde(Path(path) / DATA_DIR)}",
+        ),
         highlight=False,
         soft_wrap=True,
     )
@@ -91,21 +120,15 @@ def opened(preset: Callable[..., nu.Nu], *args: object, **kwargs: object) -> nu.
 def hold(term: nu.Nu) -> None:
     """Run a space until interrupted, then let the brackets reap the fleet.
 
-    Telemetry starts here (see :mod:`nuspace._telemetry`): on opening a
-    space, never on import. The first run event and ``space_opened`` are
-    queued, the space runs with a :class:`~nuspace.system.usage.Usage` bound
-    so the host tracks what is made and removed in it, and what is still
-    queued at the end gets a short grace to go.
+    What is still queued for telemetry (see :mod:`nuspace._telemetry`) gets
+    a short grace to go at the end. The space tells it what happens itself,
+    from its open on, the same as when opened from code.
 
     Compiled and evaluated without law validation: the space program is ours
     and tested, and validating its whole tree costs seconds per start.
     """
-    _telemetry.first_run()
-    _telemetry.track("space_opened")
     try:
-        nu.eval_in_loop(
-            nu.compile(nu.Provide(Usage, {"sink": _telemetry.track}, term)), nu.Context()
-        )
+        nu.eval_in_loop(nu.compile(term), nu.Context())
     except KeyboardInterrupt:
         console.print("[dim]Stopped[/dim]")
     finally:

nuspace-0.6.2/src/nuspace/_cli/commands/init.py

@@ -0,0 +1,60 @@
+"""``nuspace init``: make a directory a space, without opening it to run.
+
+The store only, through :func:`~nuspace.host.init_space`: ``.nuspace/``
+with its two SQLite files and the system planes, seeded as the first open
+would. Without PATH it is the current directory, said so when that sits
+inside another space. No venv, no packaging: the directory is not set up
+for code of its own yet.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import rich_click as click
+from rich.text import Text
+
+import nu
+from nuspace._branding import BLUE, PURPLE
+from nuspace.host import init_space
+from nuspace.system.kernel import find_space, is_space
+
+from .._meta import console, opened, path_argument, tilde
+
+
+__all__ = ["init"]
+
+
+@click.command(
+    short_help="Make a directory a space, without running it.",
+    help=(
+        "Make PATH a space, the current directory without one: its data in .nuspace/,"
+        " the system planes seeded, nothing run. No venv or packaging is set up yet."
+    ),
+)
+@path_argument
+def init(path: str | None) -> None:
+    """Make the space, or say it already is one."""
+    root = Path(path or ".").expanduser().resolve()
+    if path is None:
+        _warn_if_nested(root)
+    there = is_space(root)
+    term = opened(init_space, str(root))
+    nu.eval_in_loop(nu.compile(term), nu.Context())
+    what = "Already a space" if there else "Initialized a space"
+    console.print(Text.assemble((what, f"bold {PURPLE}"), ("  ", ""), (tilde(root), BLUE)))
+    again = "nuspace run" if path is None else f"nuspace run {path}"
+    console.print(Text.assemble(("open it with: ", "dim"), (again, f"bold {BLUE}")))
+
+
+def _warn_if_nested(root: Path) -> None:
+    """Say so when ``root`` sits inside another space. The home space, everyone's fallback, does not count."""
+    outer = find_space(root.parent) if root != root.parent else None
+    if outer is not None and outer != Path.home().resolve():
+        console.print(
+            Text.assemble(
+                ("inside the space at ", "yellow"),
+                (tilde(outer), BLUE),
+                (", making a new one here", "yellow"),
+            )
+        )

{nuspace-0.6.0 → nuspace-0.6.2}/src/nuspace/_cli/commands/run.py

@@ -2,23 +2,28 @@
 
 One flag, one :mod:`nuspace.host` preset: :func:`~nuspace.host.serve` by
 default, :func:`~nuspace.host.headless` with ``--headless``. Runs until
-interrupted, then the brackets reap the workers on the way out. PATH is the
-space directory, made if missing. With no path the space is a throwaway
-directory, gone at close.
+interrupted, then the brackets reap the workers on the way out. Which space
+is :func:`~nuspace._cli._meta.space_root`: PATH, made a space if it is not
+one, else the nearest space up from here, else home. ``--tmp`` is a
+throwaway one, gone at close. The header names the space's root either way.
 
 ``--with`` names a Plane an installed package adds, ``pkg.plane`` as
-``nuspace verse`` lists them: it is made in the space once, through
-:func:`~nuspace.host.with_plane`, and the tab opens on it.
+``nuspace verse`` lists them, or a bare name for a nuverse Plane: it is made
+in the space once, through :func:`~nuspace.host.with_plane`, and the tab
+opens on it. The space remembers the plane it made, so the next run with
+the same name reopens it. The header names the Plane: its id is only known
+once the space is open.
 """
 
 from __future__ import annotations
 
 import rich_click as click
 
+from nuspace.ext.registry import registered_name
 from nuspace.host import presets
 
 from .._installed import resolve
-from .._meta import STORE_ENV, announce, hold, opened, path_argument
+from .._meta import announce, hold, opened, path_argument, space_root, tmp_option
 
 
 __all__ = ["run"]
@@ -27,17 +32,20 @@ __all__ = ["run"]
 @click.command(
     short_help="Open a space, in a browser or headless.",
     help=(
-        "Open the space at PATH and serve it in a browser, or headless: kernel and"
-        f" services, nothing drawn. PATH from ${STORE_ENV}, a throwaway space without one."
+        "Open the space at PATH, made if missing, and serve it in a browser, or headless:"
+        " kernel and services, nothing drawn. Without PATH, the nearest space up from"
+        " here, else the home space at ~."
     ),
 )
 @path_argument
+@tmp_option
 @click.option(
     "--with",
     "plane",
     metavar="PLANE",
     help=(
-        "Make this plane in the space once and open on it: pkg.plane, as nuspace verse lists them."
+        "Make this plane in the space once and open on it: pkg.plane, as nuspace verse"
+        " lists them, or a bare name for a nuverse plane (jobs is nuverse.jobs)."
     ),
 )
 @click.option(
@@ -47,13 +55,20 @@ __all__ = ["run"]
 @click.option("-p", "--port", default=8080, show_default=True, help="Port to bind.")
 @click.option("--no-browser", is_flag=True, help="Do not open a browser tab on the way up.")
 def run(
-    path: str | None, plane: str | None, headless: bool, host: str, port: int, no_browser: bool
+    path: str | None,
+    tmp: bool,
+    plane: str | None,
+    headless: bool,
+    host: str,
+    port: int,
+    no_browser: bool,
 ) -> None:
     """Run until Ctrl+C."""
+    path = space_root(path, tmp=tmp)
     web = {"host": host, "port": port, "open_browser": not no_browser}
     if plane is not None:
         spec = resolve(plane)
-        made = presets.plane_id(spec)
+        made = registered_name(spec)
         if headless:
             term = opened(presets.with_plane, spec, path, web=False)
         else:

{nuspace-0.6.0 → nuspace-0.6.2}/src/nuspace/_cli/commands/telemetry.py

@@ -6,15 +6,13 @@ you open. ``NUSPACE_TELEMETRY=0`` turns it off whatever the file says.
 
 from __future__ import annotations
 
-from pathlib import Path
-
 import rich_click as click
 from rich.text import Text
 
 from nuspace import _telemetry
 from nuspace._branding import BLUE, PURPLE
 
-from .._meta import console
+from .._meta import console, tilde
 
 
 __all__ = ["telemetry"]
@@ -52,19 +50,11 @@ def _switch(on: bool) -> str:
     """How to flip it from here."""
     if on:
         return "nuspace telemetry off"
-    if _telemetry.env_override():
-        return f"unset ${_telemetry.ENV}"
+    if (name := _telemetry.env_override()) is not None:
+        return f"unset ${name}"
     return "nuspace telemetry on"
 
 
-def _where(path: Path) -> str:
-    """``path`` as a person reads it, home as ``~``."""
-    try:
-        return str(Path("~") / path.relative_to(Path.home()))
-    except ValueError:
-        return str(path)
-
-
 def _print(*lines: Text | str) -> None:
     for line in lines:
         console.print(line, highlight=False, soft_wrap=True)
@@ -77,7 +67,7 @@ def _print(*lines: Text | str) -> None:
         "Anonymous usage telemetry, set once for you across every space. It sends a few usage"
         " events, never anything from inside your spaces. Status with no command. nuspace is"
         " still young, so we'd appreciate you keeping it on."
-        f" ${_telemetry.ENV}=0 turns it off whatever is set here."
+        f" ${_telemetry.ENV}=0, $DO_NOT_TRACK or $CI turns it off whatever is set here."
     ),
 )
 @click.pass_context
@@ -92,8 +82,8 @@ def status() -> None:
     """Print the state and why, what is sent and what never is, the id, the path, how to switch."""
     on = _telemetry.telemetry_enabled()
     _print(_state_line(on))
-    if _telemetry.env_override():
-        _print(f"[dim]off by ${_telemetry.ENV}, whatever the config says[/dim]")
+    if (name := _telemetry.env_override()) is not None:
+        _print(f"[dim]off by ${name}, whatever the config says[/dim]")
     if _telemetry.is_dev_install():
         _print("[dim]dev install: nothing is sent either way[/dim]")
     _print(
@@ -103,7 +93,7 @@ def status() -> None:
         "",
         _heading("Your settings"),
         _row("id", _telemetry.distinct_id(), BLUE),
-        _row("config", _where(_telemetry.config_path()), BLUE),
+        _row("config", tilde(_telemetry.config_path()), BLUE),
         _row("turn " + ("off" if on else "on"), _switch(on), BLUE),
         "",
         f"[dim]{_WHY}[/dim]",
@@ -115,8 +105,8 @@ def on() -> None:
     """Set the flag on."""
     _telemetry.set_telemetry(True)
     _print(_state_line(True))
-    if _telemetry.env_override():
-        _print(f"[dim]still off while ${_telemetry.ENV} says so[/dim]")
+    if (name := _telemetry.env_override()) is not None:
+        _print(f"[dim]still off while ${name} says so[/dim]")
     else:
         _print("[dim]Thank you, it helps a lot while nuspace is young.[/dim]")