zero-configuration ipfs file upload with content addressing
Uploads static files and directories to IPFS via the Glitter Protocol gateway, generating immutable content identifiers (CIDs) without requiring server management or account setup. Uses a dual-path architecture: simple single-file uploads via uploadToIpfs() for files under 200MB, and chunked directory uploads via uploadToIpfsSplit() for directories up to 1GB with session-based state management to handle interruptions and resume capability.
Unique: Implements dual-path upload architecture (simple vs. chunked) with session-based resumable uploads for large directories, integrated directly into CLI without requiring separate IPFS node or pinning service account. Uses Glitter Protocol gateway as abstraction layer, eliminating need for users to manage IPFS daemon or provider credentials.
vs alternatives: Simpler than Netlify/Vercel for static sites (no build config needed) and more decentralized than traditional CDNs, but slower retrieval than centralized alternatives due to IPFS peer-dependent performance.
persistent upload history tracking with local state management
Maintains a local JSON-based history file (~/.pinme/history.json) that records all upload metadata including CIDs, timestamps, file paths, and domain bindings. Implements addHistory() and getHistory() functions to provide users with queryable records of past deployments without requiring external databases or cloud state storage, enabling reproducibility and audit trails.
Unique: Uses filesystem-based JSON history instead of cloud state or database, keeping all deployment metadata local and user-owned. Integrates directly with CLI commands to auto-record uploads without explicit user action, creating implicit audit trail.
vs alternatives: More transparent and portable than cloud-based deployment tracking (Vercel, Netlify dashboards) since history is human-readable JSON, but lacks cross-device sync and team collaboration features.
preview url generation with encrypted cid embedding
Generates temporary preview URLs at https://pinme.eth.limo/#/preview/* that embed encrypted or obfuscated CIDs, allowing users to share deployments before binding to permanent domains. Preview URLs provide time-limited or access-controlled viewing without requiring domain setup, using URL fragment-based routing to avoid exposing raw CIDs in server logs.
Unique: Uses URL fragment-based routing (#/preview/*) to embed CID without exposing it in HTTP requests, enabling preview access without server-side state. Provides immediate shareable link without requiring domain binding setup.
vs alternatives: Faster than Vercel/Netlify preview deployments (no build step) but less feature-rich (no environment variables, no preview comments). More accessible than raw IPFS gateway URLs due to human-friendly pinme.eth.limo domain.
ipfs api integration via glitter protocol gateway abstraction
Abstracts IPFS network interaction through Glitter Protocol gateway, eliminating need for users to run local IPFS nodes or manage provider credentials. Implements uploadToIpfs() and uploadToIpfsSplit() functions that communicate with gateway's HTTP API, handling content upload, chunking, and CID generation without exposing IPFS complexity to CLI users.
Unique: Abstracts IPFS complexity behind Glitter Protocol gateway, providing IPFS benefits (content addressing, decentralization) without requiring users to understand IPFS protocol or manage nodes. Gateway integration is transparent — users interact only with pinme CLI.
vs alternatives: Simpler than self-hosted IPFS (no node management) but less decentralized than running local node. More reliable than public IPFS gateways due to Glitter Protocol's dedicated infrastructure.
domain binding with dns and pinme subdomain management
Binds IPFS content (identified by CID) to human-readable domains via two mechanisms: automatic Pinme subdomains (*.pinit.eth.limo) for free users, and custom DNS domains (CNAME/TXT records) for VIP users. Implements domain binding logic in PinmeApi class with HTTP methods that communicate with Pinme backend to register domain-to-CID mappings, enabling users to access immutable content via familiar URLs.
Unique: Implements tiered domain binding: free Pinme subdomains auto-provisioned without user DNS management, plus VIP custom domain support with CNAME/TXT validation. Backend integration via PinmeApi class abstracts domain registration complexity from CLI users.
vs alternatives: Simpler than manual DNS configuration (no IPFS gateway URL management needed) but less flexible than self-hosted IPFS with custom reverse proxies. Faster than Vercel/Netlify domain setup for IPFS content since no build step required.
car file import/export for content migration and portability
Enables users to export IPFS content as Content Addressable aRchive (CAR) files for backup, migration, or sharing, and import CAR files to restore content. Implements bidirectional CAR file handling through PinmeApi integration, allowing users to migrate deployments between IPFS providers or create portable archives of their sites without relying on live IPFS network availability.
Unique: Integrates CAR file handling directly into CLI workflow via PinmeApi, abstracting IPFS-level CAR operations. Enables one-command export/import without requiring separate IPFS tools or manual DAG manipulation.
vs alternatives: More portable than relying on single IPFS provider's pinning guarantees, but requires manual CAR file management vs. automatic cloud backup systems like Vercel/Netlify.
appkey-based authentication and authorization for vip features
Implements JWT-based authentication using AppKey format (<ethereum_address>-<jwt_token>) to gate premium features including custom domain binding, CAR file operations, and VIP status checks. Validates AppKey credentials against Pinme backend via PinmeApi class, enabling role-based access control without requiring OAuth or external identity providers.
Unique: Uses Ethereum address + JWT token pair for authentication, enabling Web3-native identity without traditional OAuth. AppKey format ties authentication to blockchain identity, allowing future integration with ENS or smart contract-based access control.
vs alternatives: Simpler than OAuth for CLI tools but less secure than hardware-backed authentication. More Web3-aligned than API keys used by Vercel/Netlify, but requires users to manage long-lived credentials.
claude ai skill integration for automated deployment workflows
Exposes pinme CLI commands as a Claude Code Skill, enabling Claude AI to invoke deployment operations directly within code generation workflows. Implements LLM execution protocol that allows Claude to call upload, domain binding, and history commands with natural language instructions, automating multi-step deployment tasks without manual CLI invocation.
Unique: Implements Claude Code Skill protocol to expose CLI commands as callable functions within Claude's code generation context, enabling AI to orchestrate multi-step deployments. Bridges gap between code generation and infrastructure deployment without requiring separate CI/CD configuration.
vs alternatives: More integrated than manual CLI invocation but less flexible than custom GitHub Actions. Enables AI-driven deployment but requires Claude Code environment vs. language-agnostic CLI tools.
+4 more capabilities