๐Ÿ“ Subsystem Deep Dive

utils/deepLink/

๐Ÿ“ utils/deepLink/ ๐Ÿ“„ 6 files

Tutorial: deepLink

This project implements a secure deep linking system that allows external applications (like browsers) to launch a CLI tool via claude-cli:// URLs. It orchestrates the entire flow by handling OS-level protocol registration, strictly sanitizing inputs to prevent command injection, and intelligently detecting the user's preferred terminal emulator to start an interactive session. It also includes provenance checks to warn users about the source and content of the triggered session.

flowchart TD A0["OS Protocol Registration"] A1["URI Parsing and Sanitization"] A2["Terminal Emulator Abstraction"] A3["Deep Link Orchestration"] A4["Session Provenance & Security UI"] A3 -->|"Parses and validates URI"| A1 A3 -->|"Delegates terminal launch"| A2 A3 -->|"Retrieves repo metadata"| A4 A3 -->|"Verifies macOS bundle ID"| A0 A0 -->|"Imports protocol scheme"| A1

Chapters

  1. Deep Link Orchestration
  2. OS Protocol Registration
  3. URI Parsing and Sanitization
  4. Session Provenance & Security UI
  5. Terminal Emulator Abstraction

Generated by Code IQ

Files in this section