How does the dual-identifier system work?

It uses immutable UUIDs internally for storage and business logic while presenting stable, sequential integers (like 1, 2, 3) to the user in the CLI.

Does the system support nested notes?

Yes, it uses dot notation (e.g., 1.1.2) to provide a stable, hierarchical namespace for each level of the pad tree.

Where is the indexing logic located in the codebase?

Index generation is handled in crates/padzapp/src/index.rs, while resolution from user input is managed in crates/padzapp/src/api.rs.

What is index drift in Padz?

Index drift occurs when item IDs change based on the current search or filter view. Padz avoids this by assigning IDs based on the full, unfiltered list.

Why do pinned pads have two different indexes?

Pinned pads appear as 'pN' for quick access but retain their regular index to ensure stability when unpinning or viewing the full list.

Padz Display Identifiers

Name: Padz Display Identifiers
Author: arthur-debert

byarthur-debert

0•

Productivity & Workflow

Manages stable, user-friendly display identifiers for the Padz CLI to prevent index drift during listing, filtering, and item selection.

This skill provides the architectural logic for the Padz dual-identifier system, balancing internal UUID stability with human-readable sequential indexing. It ensures that CLI commands like listing, searching, and deleting maintain canonical ID consistency regardless of current filters or views. By implementing a three-pass indexing algorithm and supporting hierarchical tree structures with range selection, it allows developers to maintain a predictable user interface while interacting with complex note or pad structures. It specifically guides developers on using the index_pads function for output and parse_selectors for input resolution at the API boundary.

Key Features

010 GitHub stars

02Prevents index drift using a canonical three-pass sorting algorithm

03Enables hierarchical tree navigation using stable dot-notation syntax

04Implements safe range selection for bulk actions like deletion

05Decouples human-readable IDs from internal UUIDs at the API boundary

06Supports distinct identifier types for regular, pinned (p1), and deleted (d1) items

Use Cases

01Extending the Padz hierarchical tree structure with new nested elements

02Implementing new CLI commands that require stable item selection

03Debugging pad listing logic or index resolution errors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arthur-debert/padz padz-display-identifiers

For use in Claude.ai and ChatGPT

Download Skill