claude-access-for-all 0.2.0 → 0.3.0

package/README.md

@@ -1,4 +1,4 @@
-# Claude Access for All
+<h1><img src="docs/images/logo.png" width="36" height="36" align="absmiddle" alt="" />&nbsp; Claude Access for All</h1>
 
 **Frontier intelligence should serve humanity, in every corner of the world.**
 
@@ -35,6 +35,22 @@ Open knowledge can reduce confusion, expose misleading promises, help people pro
 | Local tools | Offline diagnostics, scoped launchers, browser signal inspector, and calendar reminder |
 | Evidence | Dated official sources and a contribution standard |
 
+## Session location example
+
+An example of an account's active-session view showing a reported location:
+
+![Active session showing Los Angeles, California, US as the reported location](docs/images/active-session-example.png)
+
+The displayed location is provided by the service. A process timezone setting alone does not change the network exit IP or guarantee a particular session location.
+
+## Claude Pro subscription example
+
+An example of the Claude Desktop usage screen after subscribing to Pro:
+
+![Claude Desktop usage settings showing an active Pro subscription](docs/images/pro-subscription-example.png)
+
+Plan availability and usage limits depend on your account and the provider's current terms.
+
 ## Install and run
 
 Requires macOS, Node.js 18+, Python 3.9+, and Git for the GitHub install. Install Claude Code or Claude Desktop separately when needed. Install the CLI from the npm registry or directly from GitHub.
@@ -52,7 +68,36 @@ npm install -g claude-access-for-all
 claude-access
 ```
 
-Choose an action from the interactive menu, or call one directly:
+## Command reference
+
+Run `claude-access` without arguments to open the interactive menu, or use a command directly:
+
+| Command | What it does |
+| --- | --- |
+| `claude-access` or `claude-access menu` | Open the interactive menu for diagnostics, launching clients, and reminders. |
+| `claude-access score` | Score the current terminal's timezone and UTC offset using a partial, offline heuristic. Browser-only signals are not measured. |
+| `claude-access doctor` | Check the system, Claude Code installation, and whether common environment variables are set. |
+| `claude-access audit` | Inspect the current terminal's timezone names and whether locale, proxy, endpoint, and authentication variables are set. |
+| `claude-access cli` | Launch Claude Code with process-scoped settings, requesting the Los Angeles timezone by default. |
+| `claude-access app` | Request a new Claude Desktop instance with process-scoped settings and the Los Angeles timezone by default. |
+| `claude-access desktop-shortcut` | Create a standalone macOS launcher in the current directory that requests the same Desktop settings. |
+| `claude-access web` | Open Claude in a separate Chrome profile, requesting the Los Angeles timezone by default; use `--browser edge` for Microsoft Edge. |
+| `claude-access inspect` | Open the local browser signal inspector in the default browser. |
+| `claude-access reminder --renewal YYYY-MM-DD` | Print a one-time renewal-review calendar event. Redirect the output to an `.ics` file and import it into Calendar. |
+| `claude-access guide` | Open the English privacy and access guide. |
+| `claude-access help` | Show the command list and examples. |
+| `claude-access version` | Show the installed package version. |
+
+The score is not a complete browser score, a ban prediction, or an eligibility check. Desktop and browsers may not honor the requested timezone. For available options, run a supported subcommand with `--help`, such as `claude-access web --help`.
+
+## Open Claude from the Dock
+
+Run `claude-access desktop-shortcut` to create `Claude Access Launcher.app` in the current directory. Quit Claude first, then double-click the launcher. Drag the launcher to the Dock for future launches; after Claude opens, use Command-Tab to switch to it as usual. The launcher is a separate app, and does not replace or modify Claude. An existing Claude instance may reuse state or services; the launcher cannot change an already-running process. It requests the Los Angeles timezone and English locale, but Claude or its services may read system settings independently. No change to network routing or account eligibility is made.
+
+Run `claude-access desktop-shortcut --help` to select a different output path, timezone, or locale. The launcher refuses to overwrite an existing path. To remove it, quit it and delete its `.app` bundle.
+
+## Examples
+
 
 ```sh
 claude-access doctor

package/bin/claude-access.js

@@ -16,6 +16,7 @@ Usage: claude-access [command] [options]
   score                  Score locally observable timezone signals
   cli [options] [-- ...] Launch Claude Code with scoped locale settings
   app [options]          Launch Claude Desktop with scoped locale settings
+  desktop-shortcut       Create a standalone macOS launcher app
   web [options]          Launch Claude in a separate browser profile
   inspect                Open the local browser signal inspector
   reminder [options]     Write a one-time calendar event to stdout
@@ -49,6 +50,7 @@ function dispatch(command, args = []) {
     case 'doctor': return run('python3', [join(root, 'tools/access.py'), 'doctor', ...args]);
     case 'audit': return run('python3', [join(root, 'tools/privacy.py'), 'audit', ...args]);
     case 'score': return run('python3', [join(root, 'tools/score.py'), ...args]);
+    case 'desktop-shortcut': return run('python3', [join(root, 'tools/desktop_shortcut.py'), ...args]);
     case 'cli': case 'app': case 'web':
       return run('python3', [join(root, 'tools/privacy.py'), command, ...args]);
     case 'reminder': return run('python3', [join(root, 'tools/access.py'), 'reminder', ...args]);
@@ -71,10 +73,10 @@ async function menu() {
   }
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    console.log(`\nClaude Access for All\n\n  1  Check local environment\n  2  Inspect CLI signals\n  3  Start Claude Code\n  4  Start Claude Desktop\n  5  Start Claude in a separate browser profile\n  6  Open browser signal inspector\n  7  Open the privacy guide\n  8  Create a renewal calendar file\n  9  Score local timezone signals\n  0  Exit\n`);
+    console.log(`\nClaude Access for All\n\n  1  Check local environment\n  2  Inspect CLI signals\n  3  Start Claude Code\n  4  Start Claude Desktop\n  5  Start Claude in a separate browser profile\n  6  Open browser signal inspector\n  7  Open the privacy guide\n  8  Create a renewal calendar file\n  9  Score local timezone signals\n  10 Create a macOS desktop launcher\n  0  Exit\n`);
     const choice = (await rl.question('Choose an option: ')).trim();
     if (choice === '0') return 0;
-    const simple = { '1': 'doctor', '2': 'audit', '3': 'cli', '4': 'app', '6': 'inspect', '7': 'guide', '9': 'score' };
+    const simple = { '1': 'doctor', '2': 'audit', '3': 'cli', '4': 'app', '6': 'inspect', '7': 'guide', '9': 'score', '10': 'desktop-shortcut' };
     if (simple[choice]) { rl.close(); return dispatch(simple[choice]); }
     if (choice === '5') {
       const browser = (await rl.question('Browser (chrome/edge) [chrome]: ')).trim() || 'chrome';
@@ -95,7 +97,7 @@ async function menu() {
       console.log(`Created ${output}. Import it into Calendar and check notification settings.`);
       return 0;
     }
-    console.error('Unknown option. Run the menu again to choose 0–9.');
+    console.error('Unknown option. Run the menu again to choose 0–10.');
     return 2;
   } finally { rl.close(); }
 }

package/docs/privacy-inspector.md

@@ -29,7 +29,7 @@ python3 tools/privacy.py app --timezone America/Los_Angeles --locale en_US.UTF-8
 python3 tools/privacy.py app --app '/Applications/Claude.app'
 ```
 
-This asks macOS Launch Services to open a new app instance with the specified environment values. Desktop may read OS preferences directly, reuse existing services, or use app-managed settings instead; these process overrides are an experiment, not a verified masking mechanism. Browser-based sign-in runs in its own browser process. Verify Desktop-specific behavior separately and use [official network settings](https://code.claude.com/docs/en/network-config) for network configuration.
+This asks macOS Launch Services to open a new app instance with the specified environment values. To create a clickable launcher, run `claude-access desktop-shortcut`, quit Claude, and open the newly created `Claude Access Launcher.app`. Add it to the Dock for later launches; Command-Tab switches to Claude after it is open. Desktop may read OS preferences directly, reuse existing services, or use app-managed settings instead; these process overrides are an experiment, not a verified masking mechanism. Browser-based sign-in runs in its own browser process. Verify Desktop-specific behavior separately and use [official network settings](https://code.claude.com/docs/en/network-config) for network configuration.
 
 ## 3. Claude on the web
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-access-for-all",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A macOS guide and local privacy toolkit for Claude Code, Desktop, and web",
   "license": "MIT",
   "type": "module",

package/tools/desktop_shortcut.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+"""Create a standalone macOS app that requests the Claude Access environment."""
+import argparse
+from pathlib import Path
+import plistlib
+import shlex
+import sys
+
+from privacy import validate_locale, validate_timezone
+
+
+def create_bundle(destination, timezone, locale):
+    """Create a new app bundle, refusing to overwrite an existing path."""
+    destination = Path(destination).expanduser().absolute()
+    destination.mkdir(parents=False, exist_ok=False)
+    try:
+        contents = destination / 'Contents'
+        macos = contents / 'MacOS'
+        macos.mkdir(parents=True)
+        info = {
+            'CFBundleIdentifier': 'org.claudeaccess.launcher',
+            'CFBundleName': 'Claude Access Launcher',
+            'CFBundleDisplayName': 'Claude Access Launcher',
+            'CFBundleExecutable': 'launch-claude',
+            'CFBundlePackageType': 'APPL',
+            'CFBundleShortVersionString': '1.0',
+            'LSMinimumSystemVersion': '13.0',
+            'LSUIElement': True,
+        }
+        (contents / 'Info.plist').write_bytes(plistlib.dumps(info))
+        args = ['/usr/bin/open', '-n', '-a', 'Claude',
+                '--env', 'TZ=' + timezone, '--env', 'LANG=' + locale,
+                '--env', 'LC_ALL=' + locale]
+        script = '#!/bin/sh\n# Launch Claude with explicitly scoped environment requests.\nexec ' + ' '.join(shlex.quote(arg) for arg in args) + '\n'
+        executable = macos / 'launch-claude'
+        executable.write_text(script, encoding='utf-8')
+        executable.chmod(0o755)
+    except BaseException:
+        # Only remove files created by this call; no pre-existing target is touched.
+        import shutil
+        shutil.rmtree(destination)
+        raise
+    return destination
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--output', type=Path, default=Path('Claude Access Launcher.app'),
+                        help='New .app path; parent must exist. Defaults to the current directory.')
+    parser.add_argument('--timezone', type=validate_timezone, default='America/Los_Angeles')
+    parser.add_argument('--locale', type=validate_locale, default='en_US.UTF-8')
+    args = parser.parse_args()
+    if sys.platform != 'darwin':
+        parser.error('The launcher requires macOS.')
+    if args.output.suffix != '.app':
+        parser.error('Output must end in .app.')
+    try:
+        bundle = create_bundle(args.output, args.timezone, args.locale)
+    except FileExistsError:
+        parser.error(f'Target already exists: {args.output}. Choose a different --output path.')
+    except OSError as error:
+        parser.error(str(error))
+    print(f'Created: {bundle}')
+    print('Quit Claude first, then open the launcher. You can drag it to the Dock.')
+    print('Switch to the launched Claude app with Command-Tab.')
+    print('Launch Services requests process settings; Claude may use existing services or system settings.')
+
+
+if __name__ == '__main__':
+    main()