How forwalkin/claude-local-bridge- works
Claude Local Bridge is a Node.js runtime foundation for safely exposing local Skills to an AI agent; it is not yet a chat-connected product. The intended use flow loads and validates declarative manifests, checks inputs and permissions, constrains paths to a sandbox, obtains human approval for destructive operations, then launches an isolated Python runner and audits outcomes. README documentation describes these as independently tested layers, not an already-wired end-to-end workflow. The graph reflects shown calls and documented capabilities; unsampled wiring and the future model/session interface are omitted.
Main entry points: executionEngine.js Execution Engine · createSkillRegistry.js Registry Factory · auditLogger.js Audit Logger · skillLoader.js Skill Loader
Components 22
Skill Definitions
- Workspace Cleaner
ai-skills/manifests/workspace_cleaner.json - Skill Schema
ai-skills/schemas/skill.schema.json - Project Paths
backend-node/src/config/paths.js - Skill Loader
backend-node/src/services/skillLoader.js - Manifest Validator
backend-node/src/services/skillValidator.js - Skill Registry
backend-node/src/services/skillRegistry.js - Registry Factory
backend-node/src/services/createSkillRegistry.js
Security Decisions
- Permission Engine
backend-node/src/security/permissionEngine.js - Permission Checks
backend-node/src/security/permissionChecks.js - Path Policy
backend-node/src/security/pathPolicy.js - Path Resolution
backend-node/src/security/pathResolution.js - Filesystem Sandbox
- Confirmation Manager
backend-node/src/security/confirmationManager.js - Operation Fingerprint
backend-node/src/security/operationFingerprint.js
Execution Runtime
- Execution Engine
backend-node/src/execution/executionEngine.js - Runner Resolver
backend-node/src/execution/runnerPath.js
Audit
- Audit Logger
backend-node/src/audit/auditLogger.js - Event Severity
backend-node/src/audit/eventSeverity.js - Result Adapters
backend-node/src/audit/resultEventAdapters.js - Confirmation Adapter
backend-node/src/audit/confirmationEventAdapter.js
Other components
- Skill Author
- Python Child Process
Connections 20
- Skill Author → Workspace Cleaner: declares skill
README.md - Registry Factory → Project Paths: gets paths
backend-node/src/services/createSkillRegistry.js - Registry Factory → Skill Loader: creates and loads
backend-node/src/services/createSkillRegistry.js - Skill Loader → Workspace Cleaner: reads manifests
backend-node/src/services/skillLoader.js - Skill Loader → Manifest Validator: validates manifest
backend-node/src/services/skillLoader.js - Manifest Validator → Skill Schema: compiles against
backend-node/src/services/skillValidator.js - Registry Factory → Skill Registry: registers skills
backend-node/src/services/createSkillRegistry.js - Registry Factory → Manifest Validator: supplies validator
backend-node/src/services/createSkillRegistry.js - Permission Engine → Permission Checks: runs checks
backend-node/src/security/permissionEngine.js - Path Policy → Path Resolution: resolves paths
backend-node/src/security/pathPolicy.js - Path Policy → Filesystem Sandbox: confines paths
README.md - Confirmation Manager → Operation Fingerprint: fingerprints operation
backend-node/src/security/confirmationManager.js - Execution Engine → Operation Fingerprint: recomputes fingerprint
backend-node/src/execution/executionEngine.js - Execution Engine → Confirmation Manager: consumes approval
backend-node/src/execution/executionEngine.js - Execution Engine → Runner Resolver: resolves runner
backend-node/src/execution/executionEngine.js - Execution Engine → Python Child Process: spawns runner
backend-node/src/execution/executionEngine.js - Execution Engine → Audit Logger: logs execution
backend-node/src/execution/executionEngine.js - Audit Logger → Event Severity: looks up severity
backend-node/src/audit/auditLogger.js - Result Adapters → Audit Logger: adapts results
- Confirmation Adapter → Audit Logger: adapts events