AGENTS.md

dkdc-links

Bookmarks in your terminal.

Commands

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, ty)
bin/test           # Run all tests
bin/test-rs        # Rust tests
bin/format         # Format all code
bin/install        # Install CLI (Rust + Python)
bin/bump-version   # Bump version (--patch, --minor (default), --major)

Architecture

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) with --app and --webapp flags
  src/config.rs    # Config loading/saving (~/.config/dkdc/links/config.toml)
  src/open.rs      # Link resolution (alias → link → URI)
  src/app.rs       # iced desktop app (behind `app` feature flag)
  src/webapp.rs    # Axum HTMX webapp on port 1414 (behind `webapp` feature flag)
  assets/icon.png  # App window icon
dkdc-links-py/     # PyO3 bindings (cdylib)
src/dkdc_links/    # Python wrapper + type stubs (core.pyi, py.typed)

Config structure: aliases map to links, links map to URIs, groups expand to multiple aliases/links.