anchorlink 0.1.0__tar.gz

anchorlink-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steven Quinn Singleton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

anchorlink-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: anchorlink
+Version: 0.1.0
+Summary: Anchorlink Local — a secure desktop link for Claude
+Project-URL: Homepage, https://github.com/quintessence-proof/anchorlink
+Project-URL: Issues, https://github.com/quintessence-proof/anchorlink/issues
+Author: Steven Quinn Singleton
+License: MIT
+License-File: LICENSE
+Keywords: ai-tools,anthropic,claude,desktop,filesystem,local,mcp,process
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: windows
+Requires-Dist: pywinpty>=2.0.0; extra == 'windows'
+Description-Content-Type: text/markdown
+
+# Anchorlink Local
+
+**A secure desktop link for Claude.**
+
+Anchorlink Local is a lean, hardened MCP server that gives Claude reliable,
+first-party access to your local machine — filesystem, processes, terminal
+sessions, and search — without telemetry, without third-party service
+dependencies, and without the bloat of a full desktop application.
+
+---
+
+## What it does
+
+Anchorlink Local implements the [Model Context Protocol](https://modelcontextprotocol.io)
+over stdio, making the following capabilities available to Claude for macOS,
+Claude for Windows, and any MCP-compatible client:
+
+| Capability | Notes |
+|---|---|
+| File system operations | Read, write, create, delete, move, copy, stat |
+| Structured file editing | str_replace and line-range patching |
+| Command execution | Via argument list — no `shell=True`, no metacharacter exposure |
+| Terminal session persistence | Stateful PTY sessions across tool calls |
+| File search | ripgrep primary, pathlib fallback |
+| Process listing and termination | Cross-platform via psutil |
+| Configuration controls | Allowed directories, blocked commands, runtime reload |
+| SSH bridge (optional) | Remote access via local OpenSSH — no cloud accounts required |
+
+## Design principles
+
+- **No telemetry.** Zero outbound connections to third-party analytics services.
+- **No UI layer.** Claude renders natively. No CDN dependency, no iframe complexity.
+- **No shell injection surface.** All process execution uses `execvp`-style argument
+  lists. Shell metacharacters cannot reach the interpreter.
+- **Path guard runs twice.** Symlink resolution and directory boundary checks happen
+  at input validation *and* immediately before each file operation, eliminating the
+  TOCTOU window present in comparable tools.
+- **Audit-ready logging.** Local log file, owner-only permissions, argument values
+  redacted by key pattern. The log tells you what was called, never what was passed.
+- **Minimal dependencies.** Targets 4–5 runtime packages. No framework, no ORM,
+  no cloud SDK.
+
+## Installation
+
+> **Note:** Full implementation is in progress. This release reserves the namespace.
+> Subscribe to releases on GitHub for availability updates.
+
+When available, the recommended installation method is `uvx` — no Python
+environment management required:
+
+```json
+{
+  "mcpServers": {
+    "anchorlink": {
+      "command": "uvx",
+      "args": ["anchorlink"]
+    }
+  }
+}
+```
+
+Add this block to:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+## Platform support
+
+| Platform | Status |
+|---|---|
+| macOS (Apple Silicon + Intel) | Primary |
+| Linux | Supported |
+| Windows 10/11 | Supported (requires `anchorlink[windows]` for PTY sessions) |
+
+## License
+
+MIT — Copyright © 2026 Steven Quinn Singleton

anchorlink-0.1.0/README.md

@@ -0,0 +1,76 @@
+# Anchorlink Local
+
+**A secure desktop link for Claude.**
+
+Anchorlink Local is a lean, hardened MCP server that gives Claude reliable,
+first-party access to your local machine — filesystem, processes, terminal
+sessions, and search — without telemetry, without third-party service
+dependencies, and without the bloat of a full desktop application.
+
+---
+
+## What it does
+
+Anchorlink Local implements the [Model Context Protocol](https://modelcontextprotocol.io)
+over stdio, making the following capabilities available to Claude for macOS,
+Claude for Windows, and any MCP-compatible client:
+
+| Capability | Notes |
+|---|---|
+| File system operations | Read, write, create, delete, move, copy, stat |
+| Structured file editing | str_replace and line-range patching |
+| Command execution | Via argument list — no `shell=True`, no metacharacter exposure |
+| Terminal session persistence | Stateful PTY sessions across tool calls |
+| File search | ripgrep primary, pathlib fallback |
+| Process listing and termination | Cross-platform via psutil |
+| Configuration controls | Allowed directories, blocked commands, runtime reload |
+| SSH bridge (optional) | Remote access via local OpenSSH — no cloud accounts required |
+
+## Design principles
+
+- **No telemetry.** Zero outbound connections to third-party analytics services.
+- **No UI layer.** Claude renders natively. No CDN dependency, no iframe complexity.
+- **No shell injection surface.** All process execution uses `execvp`-style argument
+  lists. Shell metacharacters cannot reach the interpreter.
+- **Path guard runs twice.** Symlink resolution and directory boundary checks happen
+  at input validation *and* immediately before each file operation, eliminating the
+  TOCTOU window present in comparable tools.
+- **Audit-ready logging.** Local log file, owner-only permissions, argument values
+  redacted by key pattern. The log tells you what was called, never what was passed.
+- **Minimal dependencies.** Targets 4–5 runtime packages. No framework, no ORM,
+  no cloud SDK.
+
+## Installation
+
+> **Note:** Full implementation is in progress. This release reserves the namespace.
+> Subscribe to releases on GitHub for availability updates.
+
+When available, the recommended installation method is `uvx` — no Python
+environment management required:
+
+```json
+{
+  "mcpServers": {
+    "anchorlink": {
+      "command": "uvx",
+      "args": ["anchorlink"]
+    }
+  }
+}
+```
+
+Add this block to:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+## Platform support
+
+| Platform | Status |
+|---|---|
+| macOS (Apple Silicon + Intel) | Primary |
+| Linux | Supported |
+| Windows 10/11 | Supported (requires `anchorlink[windows]` for PTY sessions) |
+
+## License
+
+MIT — Copyright © 2026 Steven Quinn Singleton

anchorlink-0.1.0/RESERVATION_INSTRUCTIONS.md

@@ -0,0 +1,169 @@
+# Anchorlink — PyPI Namespace Reservation
+## Step-by-step instructions
+
+---
+
+## What you'll do
+
+1. Create a PyPI account (you, in browser — 5 min)
+2. Enable two-factor authentication (you, in browser — 2 min)
+3. Generate an API token (you, in browser — 1 min)
+4. Install uv if not already present (Terminal — 30 sec)
+5. Build and publish the stub package (Terminal — 2 min)
+
+Total time: under 15 minutes.
+
+---
+
+## Step 1 — Create your PyPI account
+
+Open: https://pypi.org/account/register/
+
+Fill in:
+- Username (this becomes part of your package's public identity)
+- Email
+- Password
+
+Submit the form and verify your email address.
+
+---
+
+## Step 2 — Enable two-factor authentication (required for publishing)
+
+PyPI now requires 2FA on all accounts that publish packages.
+
+1. Go to: https://pypi.org/manage/account/two-factor/
+2. Choose either:
+   - **Authenticator app** (recommended — works with 1Password, Authy, Google Authenticator)
+   - **Security key** (FIDO2/WebAuthn hardware key)
+3. Complete setup and save your recovery codes somewhere secure.
+
+---
+
+## Step 3 — Generate an API token
+
+This token authorizes `uv publish` without your password.
+
+1. Go to: https://pypi.org/manage/account/token/
+2. Click **Add API token**
+3. Name it: `anchorlink-initial-publish`
+4. Scope: **Entire account** (you can scope it to the project after first publish)
+5. Click **Generate token**
+6. **Copy the token now** — it will not be shown again. It starts with `pypi-`.
+
+Store it somewhere safe (1Password, your password manager, etc.).
+
+---
+
+## Step 4 — Install uv (if not already present)
+
+Open Terminal and run:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Verify:
+```bash
+uv --version
+# Expected: uv 0.x.x
+```
+
+---
+
+## Step 5 — Build and publish
+
+The package files are in the `anchorlink-reserve/` folder from this package.
+Copy it to your working directory, then:
+
+```bash
+# Navigate to the package directory
+cd path/to/anchorlink-reserve
+
+# Verify the structure looks right
+ls -la
+# Expected:
+#   pyproject.toml
+#   README.md
+#   LICENSE
+#   src/
+#     anchorlink/
+#       __init__.py
+
+# Install hatchling (the build backend — used once)
+uv tool install hatchling
+
+# Build the distribution packages
+uv build
+
+# Verify the build output
+ls dist/
+# Expected:
+#   anchorlink-0.1.0-py3-none-any.whl
+#   anchorlink-0.1.0.tar.gz
+
+# Publish to PyPI
+# Replace <your-token> with the pypi-... token from Step 3
+UV_PUBLISH_TOKEN=<your-token> uv publish
+```
+
+You will see output like:
+```
+Publishing anchorlink 0.1.0 to https://upload.pypi.org/legacy/
+Uploading anchorlink-0.1.0-py3-none-any.whl
+Uploading anchorlink-0.1.0.tar.gz
+```
+
+---
+
+## Step 6 — Verify the reservation
+
+Open: https://pypi.org/project/anchorlink/
+
+You should see the project page with the README rendered.
+The namespace is now yours.
+
+---
+
+## Optional: Test on TestPyPI first
+
+TestPyPI is a staging environment — safe to experiment on without affecting
+production. Recommended if you want to verify the page renders correctly
+before the real publish.
+
+1. Create a separate account at: https://test.pypi.org/account/register/
+2. Generate a token at: https://test.pypi.org/manage/account/token/
+3. Publish to test first:
+
+```bash
+UV_PUBLISH_TOKEN=<test-token> uv publish --publish-url https://test.pypi.org/legacy/
+```
+
+4. Check: https://test.pypi.org/project/anchorlink/
+5. When satisfied, run the production publish from Step 5.
+
+---
+
+## After reservation — next steps
+
+Once the namespace is held, update `pyproject.toml`:
+- Set the correct GitHub URL once you create the repo
+- Update `authors` with your preferred public name/email
+
+When implementation begins, bump version to `0.2.0` and add the real
+dependencies and source files. PyPI allows unlimited version publishes
+under the same name once you own it.
+
+---
+
+## Package structure reference
+
+```
+anchorlink-reserve/
+├── pyproject.toml        ← Package metadata and build config
+├── README.md             ← PyPI landing page (renders on project page)
+├── LICENSE               ← MIT license
+└── src/
+    └── anchorlink/
+        └── __init__.py   ← Stub main() entrypoint
+```

anchorlink-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "anchorlink"
+version = "0.1.0"
+description = "Anchorlink Local — a secure desktop link for Claude"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "Steven Quinn Singleton" }
+]
+keywords = [
+    "mcp",
+    "claude",
+    "anthropic",
+    "desktop",
+    "local",
+    "filesystem",
+    "process",
+    "ai-tools",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+
+# Runtime dependencies are intentionally minimal.
+# Full dependency list will be added in v0.2.0.
+dependencies = [
+    "mcp>=1.0.0",
+]
+
+[project.optional-dependencies]
+windows = [
+    "pywinpty>=2.0.0",   # PTY support for terminal session persistence on Windows
+]
+
+[project.scripts]
+anchorlink = "anchorlink:main"
+
+[project.urls]
+Homepage      = "https://github.com/quintessence-proof/anchorlink"
+Issues        = "https://github.com/quintessence-proof/anchorlink/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/anchorlink"]

anchorlink-0.1.0/src/anchorlink/__init__.py

@@ -0,0 +1,23 @@
+"""
+Anchorlink Local — a secure desktop link for Claude.
+
+Provides filesystem operations, command execution, terminal session
+persistence, file search, and process management as an MCP server
+over stdio. Designed for use with Claude for macOS, Claude for Windows,
+and any MCP-compatible Claude client.
+
+Status: pre-release (namespace reservation). Full implementation in progress.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Steven Quinn Singleton"
+__license__ = "MIT"
+
+
+def main() -> None:
+    """Entry point for `uvx anchorlink` and direct CLI invocation."""
+    print(
+        "Anchorlink Local v0.1.0\n"
+        "Full MCP server implementation is in progress.\n"
+        "See https://github.com/stevensingleton/anchorlink for updates."
+    )