sync from internal repository

Author: lostmygithubaccount

CLAUDE.md

@@ -1,36 +1,34 @@
-# CLAUDE.md
+# dkdc-links
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Overview
-
-dkdc-links is a Rust CLI tool for managing terminal bookmarks. Users define aliases, links, and groups in a TOML config file, then open them via command line.
+Bookmarks in your terminal.
 
 ## Commands
 
 ```bash
-# Development
-cargo build                    # Build debug binary
-cargo run                      # Run the CLI
-cargo run -- link1 alias1      # Open specific links/aliases
-
-# Quality checks
-./bin/check.sh                 # Format, clippy, and check
-cargo fmt                      # Format code
-cargo clippy                   # Lint
-
-# Testing
-./bin/test.sh                  # Run tests and build release
-cargo test --all-features      # Run tests only
-
-# Release
-./bin/release.sh               # Clean build and publish to crates.io
+bin/build          # Build all (Rust + Python)
+bin/build-rs       # Build Rust crate
+bin/build-py       # Build Python bindings (maturin develop)
+bin/check          # Run all checks (format, lint, test)
+bin/check-rs       # Rust checks (fmt, clippy, test)
+bin/check-py       # Python checks (ruff)
+bin/test           # Run all tests
+bin/test-rs        # Rust tests
+bin/format         # Format all code
+bin/install        # Install CLI (Rust + Python)
 ```
 
 ## Architecture
 
-- `src/main.rs` - CLI entry point using clap for argument parsing
-- `src/config.rs` - Config loading/saving from `~/.config/dkdc/links/config.toml`
-- `src/open.rs` - Link resolution (alias → link → URI) and opening via system browser
+```
+dkdc-links/        # Core Rust crate (standalone, not in monorepo workspace)
+  src/lib.rs       # Library root
+  src/main.rs      # Binary entry point
+  src/cli.rs       # CLI (clap), optional `gui` subcommand
+  src/config.rs    # Config loading/saving (~/.config/dkdc/links/config.toml)
+  src/open.rs      # Link resolution (alias → link → URI)
+  src/gui.rs       # iced GUI (behind `gui` feature flag)
+dkdc-links-py/     # PyO3 bindings (cdylib)
+src/dkdc_links/    # Python wrapper
+```
 
 Config structure: aliases map to links, links map to URIs, groups expand to multiple aliases/links.