claude-access-for-all 0.1.0 → 0.1.1

package/README.md

@@ -65,7 +65,7 @@ claude-access reminder --renewal 2026-12-01 --days-before 3 > renewal.ics
 open renewal.ics
 ```
 
-To install directly from GitHub, use `npm install -g github:AMark-CS/claude-access-for-all`. Use `claude-access help` to see the complete command list. `inspect` opens the local graphical browser inspector in your default browser. To check a separate browser profile, open its local file in that profile instead; see the [privacy inspector guide](docs/privacy-inspector.md).
+To install directly from GitHub, use `npm install -g github:AMark-CS/claude-access-for-all`. Use `claude-access help` to see the complete command list. Diagnostics display a readable summary by default; use `claude-access doctor --json` or `claude-access audit --json` for machine-readable output. `inspect` opens the local graphical browser inspector in your default browser. To check a separate browser profile, open its local file in that profile instead; see the [privacy inspector guide](docs/privacy-inspector.md).
 
 For the calendar reminder, replace the example date with the next billing date shown by your billing provider. The file contains one all-day review event with an alert; import it into Apple Calendar and check your notification settings. It neither cancels nor renews anything, and must be regenerated when the billing date changes.
 

package/bin/claude-access.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
@@ -10,8 +11,8 @@ const help = `Claude Access for All
 Usage: claude-access [command] [options]
 
   menu                   Open the interactive menu (default)
-  doctor                 Check local installation and configuration presence
-  audit                  Inspect CLI environment signals locally
+  doctor [--json]        Check local installation and configuration presence
+  audit [--json]         Inspect CLI environment signals locally
   cli [options] [-- ...] Launch Claude Code with scoped locale settings
   app [options]          Launch Claude Desktop with scoped locale settings
   web [options]          Launch Claude in a separate browser profile
@@ -56,7 +57,7 @@ function dispatch(command, args = []) {
       if (process.platform !== 'darwin') { console.error('The guide launcher requires macOS.'); return 1; }
       return run('/usr/bin/open', ['https://github.com/AMark-CS/claude-access-for-all/blob/main/docs/privacy-inspector.md']);
     case 'help': case '--help': case '-h': console.log(help); return 0;
-    case 'version': case '--version': case '-v': console.log('0.1.0'); return 0;
+    case 'version': case '--version': case '-v': console.log(JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version); return 0;
     default: console.error(`Unknown command: ${command}\n\n${help}`); return 2;
   }
 }

package/package.json

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

package/tools/access.py

@@ -9,6 +9,8 @@ import shutil
 import sys
 import uuid
 
+from report import render_doctor
+
 VARIABLES = (
     'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_BASE_URL',
     'CLAUDE_CODE_USE_BEDROCK', 'CLAUDE_CODE_USE_VERTEX', 'CLAUDE_CODE_USE_FOUNDRY',
@@ -92,13 +94,15 @@ def reminder(renewal, lead, today=None):
 def main():
     parser = argparse.ArgumentParser(description=__doc__)
     commands = parser.add_subparsers(dest='command', required=True)
-    commands.add_parser('doctor', help='Print an offline JSON report; values stay private.')
+    diagnostic = commands.add_parser('doctor', help='Print an offline environment report.')
+    diagnostic.add_argument('--json', action='store_true', help='Output machine-readable JSON.')
     calendar = commands.add_parser('reminder', help='Print a one-time .ics calendar to stdout.')
     calendar.add_argument('--renewal', type=parse_date, required=True)
     calendar.add_argument('--days-before', type=days_before, default=3)
     args = parser.parse_args()
     if args.command == 'doctor':
-        print(json.dumps(doctor(), indent=2))
+        result = doctor()
+        print(json.dumps(result, indent=2) if args.json else render_doctor(result))
     else:
         try:
             content = reminder(args.renewal, args.days_before)

package/tools/privacy.py

@@ -12,6 +12,8 @@ import sys
 import tempfile
 import time
 
+from report import render_audit
+
 ROUTING = ('ANTHROPIC_BASE_URL', 'HTTP_PROXY', 'HTTPS_PROXY', 'ALL_PROXY', 'NO_PROXY',
            'http_proxy', 'https_proxy', 'all_proxy', 'no_proxy')
 AUTH = ('ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN')
@@ -65,7 +67,8 @@ def browser_command(browser, profile, language, timezone, locale):
 def main():
     parser = argparse.ArgumentParser(description=__doc__)
     sub = parser.add_subparsers(dest='command', required=True)
-    sub.add_parser('audit', help='Show local signal presence without exposing secret values.')
+    diagnostic = sub.add_parser('audit', help='Show local signals without exposing secret values.')
+    diagnostic.add_argument('--json', action='store_true', help='Output machine-readable JSON.')
     for name in ('cli', 'app', 'web'):
         command = sub.add_parser(name, help='Launch ' + name + ' with process-scoped settings.')
         command.add_argument('--timezone', type=validate_timezone, default='UTC')
@@ -80,7 +83,8 @@ def main():
             command.add_argument('--language', default='en-US', type=validate_locale)
     args = parser.parse_args()
     if args.command == 'audit':
-        print(json.dumps(audit(), indent=2))
+        result = audit()
+        print(json.dumps(result, indent=2) if args.json else render_audit(result))
         return
     if sys.platform != 'darwin':
         parser.error('Launch commands require macOS.')

package/tools/report.py

@@ -0,0 +1,85 @@
+"""Readable, privacy-conscious CLI reports. JSON remains available via --json."""
+import os
+import sys
+
+
+def style(text, code):
+    if sys.stdout.isatty() and not os.environ.get('NO_COLOR') and os.environ.get('TERM') != 'dumb':
+        return f'\033[{code}m{text}\033[0m'
+    return text
+
+
+def title(name, subtitle):
+    return [
+        '',
+        '  ' + style('CLAUDE ACCESS', '1;36') + style('  /  ' + name.upper(), '1'),
+        '  ' + style(subtitle, '2'),
+        '',
+    ]
+
+
+def row(label, value):
+    return f'  {label:<20} {value}'
+
+
+def section(name):
+    return '\n  ' + style(name, '1')
+
+
+def group(label, names, values):
+    active = [name for name in names if values.get(name)]
+    if active:
+        return row(label, style('Set', '33') + '  ' + ', '.join(active))
+    return row(label, style('Not set', '2'))
+
+
+def render_doctor(report):
+    env = report['environment_set']
+    system = report['system']
+    if system == 'Darwin':
+        system = 'macOS ' + (report['macos_version'] or '(version unavailable)')
+    lines = title('Environment check', 'Local diagnostic · no network requests')
+    lines += [
+        row('System', system + '  ·  ' + report['architecture']),
+        row('Claude Code', style('Found on PATH', '32') if report['claude_on_path'] else style('Not found on PATH', '33')),
+        section('Environment variables'),
+        group('Authentication', ('ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN'), env),
+        group('Service endpoint', ('ANTHROPIC_BASE_URL',), env),
+        group('Cloud providers', ('CLAUDE_CODE_USE_BEDROCK', 'CLAUDE_CODE_USE_VERTEX', 'CLAUDE_CODE_USE_FOUNDRY'), env),
+        group('Proxy variables', ('HTTP_PROXY', 'HTTPS_PROXY', 'ALL_PROXY', 'NO_PROXY', 'http_proxy', 'https_proxy', 'all_proxy', 'no_proxy'), env),
+        group('TLS settings', ('NODE_EXTRA_CA_CERTS', 'NODE_TLS_REJECT_UNAUTHORIZED'), env),
+        '',
+    ]
+    if report['warnings']:
+        lines.append('  ' + style('Things to review', '1;33'))
+        lines.extend('  • ' + warning for warning in report['warnings'])
+    else:
+        lines.append('  ' + style('No local configuration warnings.', '32'))
+    lines += ['', '  Values are never shown. System proxies, app settings, credentials,',
+              '  billing, account eligibility and network access were not checked.', '']
+    return '\n'.join(lines)
+
+
+def render_audit(report):
+    names = list(dict.fromkeys(name for name in report['process_timezone_names'] if name))
+    tz = ' / '.join(names) if names else 'Unavailable'
+    lines = title('CLI signal audit', 'Current terminal process · offline')
+    lines += [
+        row('System', report['system']),
+        row('Claude Code', style('Found on PATH', '32') if report['claude_on_path'] else style('Not found on PATH', '33')),
+        section('Locale & time'),
+        row('Timezone names', tz),
+        row('TZ override', style('Set', '33') if report['timezone_override_set'] else style('Not set', '2')),
+        group('Locale variables', ('LANG', 'LC_ALL', 'LC_TIME'), report['locale_overrides_set']),
+        section('Connection & authentication'),
+        group('Endpoint & proxies', report['routing_overrides_set'].keys(), report['routing_overrides_set']),
+        group('Credentials', report['credential_overrides_set'].keys(), report['credential_overrides_set']),
+        '',
+        '  Values are never shown. HKT and other abbreviations are timezone names,',
+        '  not proof of an exact location. Browser, Desktop, network, IP and',
+        '  account status were not checked.',
+        '',
+        '  Next: run ' + style('claude-access inspect', '1') + ' to inspect your default browser.',
+        '',
+    ]
+    return '\n'.join(lines)