netbox-super-cli 1.3.1__tar.gz → 1.5.0__tar.gz

netbox_super_cli-1.5.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,127 @@
+name: 🐞 Bug report
+description: Something in nsc (the CLI or TUI) behaves incorrectly or crashes.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for filing a bug! The version numbers and the **exact command** make
+        most issues reproducible — please fill in as much as you can.
+
+        > [!WARNING]
+        > **Redact secrets.** Never paste your `NSC_TOKEN`, API tokens, or any
+        > credential. Replace them with `***`.
+
+  - type: input
+    id: nsc-version
+    attributes:
+      label: nsc version
+      description: Output of `nsc --version`.
+      placeholder: "nsc 1.4.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: install-method
+    attributes:
+      label: How did you install nsc?
+      options:
+        - uv tool install
+        - pipx
+        - pip
+        - uvx (ephemeral)
+        - from source / git checkout
+        - other
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      description: Output of `python --version` for the interpreter nsc runs under.
+      placeholder: "3.12.x"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - Linux
+        - macOS
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: netbox-version
+    attributes:
+      label: NetBox version
+      description: The NetBox server version nsc talks to (NetBox UI footer, or `/api/status/`).
+      placeholder: "v4.6.3"
+    validations:
+      required: false
+
+  - type: dropdown
+    id: schema-source
+    attributes:
+      label: Which schema was nsc using?
+      description: nsc generates commands from the OpenAPI schema — a live fetch, the on-disk cache, or the bundled offline snapshot.
+      options:
+        - Live NetBox API
+        - Cached schema
+        - Bundled offline snapshot
+        - Not sure
+    validations:
+      required: false
+
+  - type: textarea
+    id: command
+    attributes:
+      label: Command you ran
+      description: The exact `nsc ...` invocation. Redact tokens.
+      render: shell
+      placeholder: nsc dcim devices list --site-id 42 --output json
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: The actual behavior, including any error message or traceback.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs / audit output
+      description: Optional. Anything else that helps — re-run with extra output if useful. Redact secrets first.
+      render: shell
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and this isn't a duplicate.
+          required: true
+        - label: I'm on the latest release of nsc, or I noted my version above.
+          required: true
+        - label: I removed any tokens / credentials from the command and logs above.
+          required: true

netbox_super_cli-1.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📖 Documentation
+    url: https://thomaschristory.github.io/netbox-super-cli/
+    about: Guides, the CLI/TUI reference, and configuration docs — please check here first.
+  - name: 💬 Questions & usage help
+    url: https://github.com/thomaschristory/netbox-super-cli/discussions
+    about: Ask how-to questions, share setups, or propose ideas before filing a feature request.
+  - name: 🔐 Security vulnerability
+    url: https://github.com/thomaschristory/netbox-super-cli/security/advisories/new
+    about: Report a security issue privately. Please do NOT open a public issue for vulnerabilities.

netbox_super_cli-1.5.0/.github/ISSUE_TEMPLATE/docs.yml

@@ -0,0 +1,35 @@
+name: 📖 Documentation issue
+description: A gap, error, or confusing part of the docs, README, or bundled SKILL.
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: where
+    attributes:
+      label: Where is the problem?
+      description: A page URL, a file path (e.g. `README.md`, `docs/...`), or a command's `--help` output.
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What's wrong or missing?
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested fix
+      description: Optional — a sentence, a corrected snippet, or a link to the right info.
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and this isn't a duplicate.
+          required: true

netbox_super_cli-1.5.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,68 @@
+name: ✨ Feature request
+description: Suggest a new capability or improvement for the CLI, TUI, or output.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the idea! Describing the **problem** first (not just the
+        solution) helps us find the best fit. nsc is generated from NetBox's
+        OpenAPI schema, so features usually apply across every resource.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Which area?
+      options:
+        - CLI (commands, flags, output)
+        - TUI (interactive browser)
+        - Output / formatting (table, json, jsonl, yaml, csv)
+        - Config / auth / profiles
+        - Shell completion
+        - Schema / code generation
+        - Documentation
+        - Other / not sure
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+      description: What are you trying to do, and where does nsc get in the way today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like nsc to do? A sketch of the command, flag, or UX is great.
+    validations:
+      required: false
+
+  - type: textarea
+    id: example
+    attributes:
+      label: Example usage
+      description: How would it look on the command line (or in the TUI)?
+      render: shell
+      placeholder: nsc dcim devices list --some-new-flag
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Before submitting
+      options:
+        - label: I searched existing issues and this isn't a duplicate.
+          required: true

netbox_super_cli-1.5.0/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+<!--
+Thanks for contributing to netbox-super-cli! Keep this short — a couple of
+sentences plus the checklist is plenty. See CLAUDE.md / docs/contributing for
+conventions.
+-->
+
+## What & why
+
+<!-- What does this change, and why? Link the issue: Closes #123 -->
+
+## Checklist
+
+- [ ] PR title follows [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, `chore:`, `refactor:`, …)
+- [ ] Tests added or updated, and `just test` passes
+- [ ] `just lint` passes (ruff + `mypy --strict`)
+- [ ] Docs / `CHANGELOG.md` updated if this is user-facing
+- [ ] Linked the related issue (e.g. `Closes #…`)

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/.github/workflows/test.yml

@@ -10,12 +10,11 @@ permissions:
 
 jobs:
   test:
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest]
-        python: ["3.12", "3.13"]
+        python: ["3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v7
       - name: Install uv

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to netbox-super-cli are tracked here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) loosely. From v1.0.0 onward, releases follow [Semantic Versioning](https://semver.org/) and the version in `pyproject.toml` matches the git tag. Pre-1.0 milestones (Phase 1-5) were pinned by tag while `pyproject.toml` stayed at `0.0.1`.
 
+## v1.5.0 — 2026-06-29
+
+Minor release. Saved searches become interchangeable with the NetBox web UI.
+
+### Changed
+
+- **Saved searches are now NetBox-native** ([#129]). Filter sets saved from the
+  TUI (`Ctrl+W`) and applied via `--saved` are stored as NetBox saved filters
+  (`extras.saved-filters`), scoped to the resource's object type, so they are
+  fully interchangeable with the web UI's filter dropdown — a search saved in
+  `nsc` appears in the web UI and vice versa. The object type is resolved from
+  NetBox's own object-type registry (`/api/core/object-types/`), so the mapping
+  is exact rather than guessed. When NetBox is unreachable or the user lacks
+  permission on `extras.savedfilter`, saves/loads transparently fall back to the
+  previous local `config.yaml` store and surface a notice instead of failing.
+
+[#129]: https://github.com/thomaschristory/netbox-super-cli/issues/129
+
+## v1.4.0 — 2026-06-26
+
+Minor release. Three user-facing features for the interactive TUI and table
+output: individually selectable custom-field columns, local saved searches, and
+NetBox-native object colors.
+
+### Added
+
+- **Individually selectable custom fields** ([#121], closes [#118]). The TUI
+  column chooser (`f` — Fields) now expands `custom_fields` into one toggleable
+  column per custom field (`custom_fields.<name>`) instead of a single opaque
+  object. On the CLI, `--columns custom_fields.<name>` selects an individual
+  custom field (now documented).
+- **Saved searches** ([#123], closes [#119]). Named filter sets persist per
+  resource. In the TUI filter builder, `Ctrl+W` saves the current filters under
+  a name and `Ctrl+O` opens a picker to apply one (`d` deletes an entry). On the
+  CLI, `--saved <name>` re-applies a saved filter set on `list`; explicit
+  `--filter` and typed options take precedence over saved values. Names
+  containing `.` (or whitespace) are rejected to keep the config file well-formed.
+- **NetBox object colors** ([#122], closes [#120]). Role, tag, and other
+  color-bearing fields render in their NetBox-defined colors in table output. A
+  new `object_colors` setting (`auto`/`on`/`off`) and the
+  `--object-colors/--no-object-colors` flag toggle this independently of
+  `--color`; `off`, `NO_COLOR`, and non-TTY output are always respected.
+
+[#118]: https://github.com/thomaschristory/netbox-super-cli/issues/118
+[#119]: https://github.com/thomaschristory/netbox-super-cli/issues/119
+[#120]: https://github.com/thomaschristory/netbox-super-cli/issues/120
+[#121]: https://github.com/thomaschristory/netbox-super-cli/pull/121
+[#122]: https://github.com/thomaschristory/netbox-super-cli/pull/122
+[#123]: https://github.com/thomaschristory/netbox-super-cli/pull/123
+
 ## v1.3.1 — 2026-06-25
 
 Patch release. CI maintenance only — no runtime or user-facing changes.

netbox_super_cli-1.3.1/README.md → netbox_super_cli-1.5.0/PKG-INFO

@@ -1,6 +1,61 @@
-# netbox-super-cli (`nsc`)
-
-A Python CLI for [NetBox](https://netbox.dev/) that builds its command tree dynamically from your install's live OpenAPI schema. The same binary works against any NetBox version and exposes plugin-provided endpoints automatically — the schema, not hand-written code, defines the surface.
+Metadata-Version: 2.4
+Name: netbox-super-cli
+Version: 1.5.0
+Summary: Dynamic NetBox CLI generated from the live OpenAPI schema.
+Project-URL: Homepage, https://github.com/thomaschristory/netbox-super-cli
+Project-URL: Documentation, https://thomaschristory.github.io/netbox-super-cli/
+Project-URL: Source, https://github.com/thomaschristory/netbox-super-cli
+Project-URL: Issues, https://github.com/thomaschristory/netbox-super-cli/issues
+Project-URL: Changelog, https://github.com/thomaschristory/netbox-super-cli/blob/main/CHANGELOG.md
+Author: Thomas Christory
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: automation,cli,netbox,openapi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=13.7
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: structlog>=24.1
+Requires-Dist: textual>=0.50
+Requires-Dist: typer<0.27,>=0.26
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# netbox-super-cli&nbsp;·&nbsp;`nsc`
+
+**A Python CLI for [NetBox](https://netbox.dev/) that builds its entire command tree from your install's live OpenAPI schema.**
+
+One binary, any NetBox version, every plugin endpoint — the schema, not hand-written code, defines the surface.
+
+<br/>
+
+[![PyPI version](https://img.shields.io/pypi/v/netbox-super-cli?style=flat-square&logo=pypi&logoColor=white&label=pypi)](https://pypi.org/project/netbox-super-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/netbox-super-cli?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/netbox-super-cli/)
+[![Downloads](https://img.shields.io/pypi/dm/netbox-super-cli?style=flat-square&label=downloads)](https://pypi.org/project/netbox-super-cli/)
+[![License](https://img.shields.io/badge/license-Apache_2.0-green?style=flat-square)](LICENSE)
+[![Tests](https://img.shields.io/github/actions/workflow/status/thomaschristory/netbox-super-cli/test.yml?branch=main&style=flat-square&label=tests)](https://github.com/thomaschristory/netbox-super-cli/actions/workflows/test.yml)
+[![Docs](https://img.shields.io/badge/docs-online-blue?style=flat-square)](https://thomaschristory.github.io/netbox-super-cli/)
+[![Stars](https://img.shields.io/github/stars/thomaschristory/netbox-super-cli?style=flat-square)](https://github.com/thomaschristory/netbox-super-cli/stargazers)
+
+[**📚 Documentation**](https://thomaschristory.github.io/netbox-super-cli/) &nbsp;·&nbsp; [**🚀 Install**](#install) &nbsp;·&nbsp; [**🖥️ Interactive TUI**](#interactive-tui) &nbsp;·&nbsp; [**🤖 AI Skill**](#bundled-skill-for-ai-agents)
+
+</div>
+
+---
 
 > **Docs:** [thomaschristory.github.io/netbox-super-cli](https://thomaschristory.github.io/netbox-super-cli/) — the full guide, including install, first-run, guides, and the auto-generated CLI/config/exit-code reference.
 
@@ -45,7 +100,9 @@ nsc tui devices    # jump straight into the devices list
 Highlights: a collapsible resource picker, a web-UI-style filter builder (`/`),
 inline record editing with a confirm-diff save, schema-derived relationship
 drill-down, bulk edit with a per-record preview, a persisted column chooser
-(`f`), and global search (`Ctrl`+`F`). Full walkthrough in the
+(`f`) that lists each custom field individually, and global search (`Ctrl`+`F`).
+The same dotted paths work on the CLI: `nsc ls devices --columns id,name,custom_fields.rack_role`.
+Full walkthrough in the
 [Interactive TUI guide](https://thomaschristory.github.io/netbox-super-cli/guides/interactive-tui/).
 
 ## Reading
@@ -61,6 +118,41 @@ uv run nsc circuits providers list --output csv
 uv run nsc ipam prefixes list --filter created__gte=2026-01-01 --output yaml
 ```
 
+### Saved searches
+
+Filter sets you save from the TUI (Ctrl+W in the filter builder) are stored as
+**NetBox native saved filters** (`extras.saved-filters`), scoped to the resource's
+object type. A search you save in `nsc` shows up in the NetBox web UI's filter
+dropdown for that object — and a filter saved in the web UI loads in the TUI
+(Ctrl+O) — so the two are fully interchangeable. Re-apply one on the CLI with
+`--saved`:
+
+```sh
+uv run nsc dcim devices list --saved active-switches
+# explicit --filter / typed options override the saved values:
+uv run nsc dcim devices list --saved active-switches --status offline
+```
+
+When NetBox is unreachable (offline, or missing permission on
+`extras.savedfilter`), `nsc` transparently falls back to a local store under
+`saved_searches` in `~/.nsc/config.yaml`, keyed by tag/resource, and tells you it
+did so.
+
+### Object colors
+
+NetBox assigns colors to roles, tags, and similar fields. In table output `nsc`
+renders those values in their NetBox-defined colors:
+
+```sh
+uv run nsc dcim devices list                      # colored when stdout is a TTY
+uv run nsc dcim devices list --no-object-colors   # plain text
+```
+
+Toggle it independently of `--color` with the `object_colors` setting
+(`auto`/`on`/`off`) or the `--object-colors/--no-object-colors` flag. `off`,
+`NO_COLOR`, and non-TTY output are always respected, so piped or redirected
+output stays uncolored.
+
 ## Writing
 
 ```sh

netbox_super_cli-1.3.1/PKG-INFO → netbox_super_cli-1.5.0/README.md

@@ -1,35 +1,26 @@
-Metadata-Version: 2.4
-Name: netbox-super-cli
-Version: 1.3.1
-Summary: Dynamic NetBox CLI generated from the live OpenAPI schema.
-Project-URL: Homepage, https://github.com/thomaschristory/netbox-super-cli
-Project-URL: Issues, https://github.com/thomaschristory/netbox-super-cli/issues
-Author-email: Thomas <mick27@gmail.com>
-License-Expression: Apache-2.0
-License-File: LICENSE
-Keywords: automation,cli,netbox,openapi
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: System :: Networking
-Requires-Python: >=3.12
-Requires-Dist: click>=8.1
-Requires-Dist: httpx>=0.27
-Requires-Dist: platformdirs>=4.2
-Requires-Dist: pydantic>=2.7
-Requires-Dist: rich>=13.7
-Requires-Dist: ruamel-yaml>=0.18
-Requires-Dist: structlog>=24.1
-Requires-Dist: textual>=0.50
-Requires-Dist: typer<0.27,>=0.26
-Description-Content-Type: text/markdown
-
-# netbox-super-cli (`nsc`)
-
-A Python CLI for [NetBox](https://netbox.dev/) that builds its command tree dynamically from your install's live OpenAPI schema. The same binary works against any NetBox version and exposes plugin-provided endpoints automatically — the schema, not hand-written code, defines the surface.
+<div align="center">
+
+# netbox-super-cli&nbsp;·&nbsp;`nsc`
+
+**A Python CLI for [NetBox](https://netbox.dev/) that builds its entire command tree from your install's live OpenAPI schema.**
+
+One binary, any NetBox version, every plugin endpoint — the schema, not hand-written code, defines the surface.
+
+<br/>
+
+[![PyPI version](https://img.shields.io/pypi/v/netbox-super-cli?style=flat-square&logo=pypi&logoColor=white&label=pypi)](https://pypi.org/project/netbox-super-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/netbox-super-cli?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/netbox-super-cli/)
+[![Downloads](https://img.shields.io/pypi/dm/netbox-super-cli?style=flat-square&label=downloads)](https://pypi.org/project/netbox-super-cli/)
+[![License](https://img.shields.io/badge/license-Apache_2.0-green?style=flat-square)](LICENSE)
+[![Tests](https://img.shields.io/github/actions/workflow/status/thomaschristory/netbox-super-cli/test.yml?branch=main&style=flat-square&label=tests)](https://github.com/thomaschristory/netbox-super-cli/actions/workflows/test.yml)
+[![Docs](https://img.shields.io/badge/docs-online-blue?style=flat-square)](https://thomaschristory.github.io/netbox-super-cli/)
+[![Stars](https://img.shields.io/github/stars/thomaschristory/netbox-super-cli?style=flat-square)](https://github.com/thomaschristory/netbox-super-cli/stargazers)
+
+[**📚 Documentation**](https://thomaschristory.github.io/netbox-super-cli/) &nbsp;·&nbsp; [**🚀 Install**](#install) &nbsp;·&nbsp; [**🖥️ Interactive TUI**](#interactive-tui) &nbsp;·&nbsp; [**🤖 AI Skill**](#bundled-skill-for-ai-agents)
+
+</div>
+
+---
 
 > **Docs:** [thomaschristory.github.io/netbox-super-cli](https://thomaschristory.github.io/netbox-super-cli/) — the full guide, including install, first-run, guides, and the auto-generated CLI/config/exit-code reference.
 
@@ -74,7 +65,9 @@ nsc tui devices    # jump straight into the devices list
 Highlights: a collapsible resource picker, a web-UI-style filter builder (`/`),
 inline record editing with a confirm-diff save, schema-derived relationship
 drill-down, bulk edit with a per-record preview, a persisted column chooser
-(`f`), and global search (`Ctrl`+`F`). Full walkthrough in the
+(`f`) that lists each custom field individually, and global search (`Ctrl`+`F`).
+The same dotted paths work on the CLI: `nsc ls devices --columns id,name,custom_fields.rack_role`.
+Full walkthrough in the
 [Interactive TUI guide](https://thomaschristory.github.io/netbox-super-cli/guides/interactive-tui/).
 
 ## Reading
@@ -90,6 +83,41 @@ uv run nsc circuits providers list --output csv
 uv run nsc ipam prefixes list --filter created__gte=2026-01-01 --output yaml
 ```
 
+### Saved searches
+
+Filter sets you save from the TUI (Ctrl+W in the filter builder) are stored as
+**NetBox native saved filters** (`extras.saved-filters`), scoped to the resource's
+object type. A search you save in `nsc` shows up in the NetBox web UI's filter
+dropdown for that object — and a filter saved in the web UI loads in the TUI
+(Ctrl+O) — so the two are fully interchangeable. Re-apply one on the CLI with
+`--saved`:
+
+```sh
+uv run nsc dcim devices list --saved active-switches
+# explicit --filter / typed options override the saved values:
+uv run nsc dcim devices list --saved active-switches --status offline
+```
+
+When NetBox is unreachable (offline, or missing permission on
+`extras.savedfilter`), `nsc` transparently falls back to a local store under
+`saved_searches` in `~/.nsc/config.yaml`, keyed by tag/resource, and tells you it
+did so.
+
+### Object colors
+
+NetBox assigns colors to roles, tags, and similar fields. In table output `nsc`
+renders those values in their NetBox-defined colors:
+
+```sh
+uv run nsc dcim devices list                      # colored when stdout is a TTY
+uv run nsc dcim devices list --no-object-colors   # plain text
+```
+
+Toggle it independently of `--color` with the `object_colors` setting
+(`auto`/`on`/`off`) or the `--object-colors/--no-object-colors` flag. `off`,
+`NO_COLOR`, and non-TTY output are always respected, so piped or redirected
+output stays uncolored.
+
 ## Writing
 
 ```sh

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/docs/guides/interactive-tui.md

@@ -81,11 +81,27 @@ NetBox list endpoint exposes hundreds of query parameters.
 | <kbd>↓</kbd> | Move to the next field (from a text field) |
 | <kbd>Tab</kbd> / <kbd>Shift</kbd>+<kbd>Tab</kbd> | Move between fields |
 | <kbd>Ctrl</kbd>+<kbd>S</kbd> | Apply |
+| <kbd>Ctrl</kbd>+<kbd>W</kbd> | Save the current filters as a named search |
+| <kbd>Ctrl</kbd>+<kbd>O</kbd> | Load (or delete) a saved search |
 | <kbd>Esc</kbd> | Cancel |
 
 Applying re-queries the list. Reopening the builder shows your current filters
 so you can refine them.
 
+### Saved searches
+
+<kbd>Ctrl</kbd>+<kbd>W</kbd> stores the current filter set as a NetBox **native
+saved filter** (`extras.saved-filters`), scoped to the current resource's object
+type. It then appears in the NetBox web UI's filter dropdown for that object, and
+filters created in the web UI load here with <kbd>Ctrl</kbd>+<kbd>O</kbd> — the two
+surfaces are interchangeable. In the load picker, <kbd>Enter</kbd> applies the
+highlighted search and <kbd>d</kbd> deletes it. Re-apply one non-interactively
+with `nsc <app> <resource> list --saved <name>`.
+
+If NetBox is unreachable (offline, or you lack permission on
+`extras.savedfilter`), saves and loads transparently fall back to a local store in
+`~/.nsc/config.yaml` and a toast tells you the fallback was used.
+
 ## Viewing and editing a record
 
 The detail view **is** the edit surface — there is no separate "edit window".

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/docs/reference/config.md

@@ -11,8 +11,9 @@ All fields below describe `~/.nsc/config.yaml`.
 |---|---|---|
 | `default_profile` | `str | None` | `None` |
 | `profiles` | `dict[str, Profile]` | `{}` |
-| `defaults` | `<class 'Defaults'>` | `Defaults(output=<OutputFormat.TABLE: 'table'>, page_size=50, timeout=30.0, schema_refresh=<SchemaRefresh.DAILY: 'daily'>, color_mode=<ColorMode.AUTO: 'auto'>, audit_redaction=<AuditRedaction.SAFE: 'safe'>)` |
+| `defaults` | `<class 'Defaults'>` | `Defaults(output=<OutputFormat.TABLE: 'table'>, page_size=50, timeout=30.0, schema_refresh=<SchemaRefresh.DAILY: 'daily'>, color_mode=<ColorMode.AUTO: 'auto'>, object_colors=<ObjectColorMode.AUTO: 'auto'>, audit_redaction=<AuditRedaction.SAFE: 'safe'>)` |
 | `columns` | `dict[str, dict[str, list[str]]]` | `{}` |
+| `saved_searches` | `dict[str, dict[str, dict[str, dict[str, str]]]]` | `{}` |
 
 ## `Profile`
 
@@ -34,4 +35,5 @@ All fields below describe `~/.nsc/config.yaml`.
 | `timeout` | `<class 'float'>` | `30.0` |
 | `schema_refresh` | `<enum 'SchemaRefresh'>` | `<SchemaRefresh.DAILY: 'daily'>` |
 | `color_mode` | `<enum 'ColorMode'>` | `<ColorMode.AUTO: 'auto'>` |
+| `object_colors` | `<enum 'ObjectColorMode'>` | `<ObjectColorMode.AUTO: 'auto'>` |
 | `audit_redaction` | `<enum 'AuditRedaction'>` | `<AuditRedaction.SAFE: 'safe'>` |

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/nsc/_version.py

@@ -1,3 +1,3 @@
 """Single source of truth for the package version."""
 
-__version__ = "1.3.1"
+__version__ = "1.5.0"

{netbox_super_cli-1.3.1 → netbox_super_cli-1.5.0}/nsc/cli/app.py

@@ -94,6 +94,14 @@ def _extract_global_overrides(args: list[str]) -> CLIOverrides:
             kwargs["refresh_schema"] = True
             i += 1
             continue
+        if a == "--object-colors":
+            kwargs["object_colors"] = True
+            i += 1
+            continue
+        if a == "--no-object-colors":
+            kwargs["object_colors"] = False
+            i += 1
+            continue
         i += 1
     return CLIOverrides(**kwargs)  # type: ignore[arg-type]
 
@@ -310,6 +318,13 @@ def _root(
         ),
     ] = False,
     output: Annotated[str | None, typer.Option("--output", "-o")] = None,
+    object_colors: Annotated[
+        bool | None,
+        typer.Option(
+            "--object-colors/--no-object-colors",
+            help="Render NetBox-native object colors (role/tag/…) in table output.",
+        ),
+    ] = None,
     debug: Annotated[bool, typer.Option("--debug")] = False,
 ) -> None:
     """Root callback — global options live here."""
@@ -321,6 +336,7 @@ def _root(
         schema_override=schema,
         refresh_schema=refresh_schema,
         output=output,
+        object_colors=object_colors,
     )
     try:
         config = load_config(default_paths().config_file)