How trentongage11/remote-ai-access works
Remote AI Access is a hosted multi-provider AI web app: users chat through a browser or SDK, with server-held provider credentials and optional agent tools. The server also exposes workspace file/search and code-map operations, snapshots, sharing, archive, audit/activity, and review/subagent capabilities. README documents these branches, but excerpts show only selected server calls and storage boundaries; edges are limited to those visible in excerpts or stated explicitly in the README.
Main entry points: server.js HTTP API · app.js Chat UI · chat-job-queue.js Chat Job Queue · client.py Python SDK
Components 25
User Clients
- Chat UI
public/app.js - Provider Selection
public/provider-selection.js - Python SDK
python-sdk/remote_ai_access/client.py - Async SDK
python-sdk/remote_ai_access/async_client.py
Chat Runtime
- HTTP API
src/server.js - Chat Context
src/chat-context.js - Provider Config
src/provider-config.js - Provider Retry
src/provider-retry.js - AI Providers
- Chat Job Queue
src/chat-job-queue.js - Job Persistence
src/chat-job-persistence.js
Workspace Tools
- File Lab
public/filelab.js - Workspace Search
src/workspace-search.js - Code Map
src/code-map.js - Git Snapshots
src/git-change-center.js - File Sharing
src/server.js
History and Oversight
- Chat Archive
src/chat-archive-store.js - Audit Log
public/audit.js - Activity Timeline
src/workspace-activity.js
Agent Workflows
- Recipe Schedules
src/agent-recipe-schedule.js - Subagent Policies
src/subagent-policy.js - Subagent Results
src/subagent-results.js - Review Workflow
src/review-workflow.js - TDD Workflow
src/tdd-workflow.js
Other components
- User
Connections 24
- User → Chat UI: uses
README.md - Chat UI → Provider Selection: selects models
public/app.js - Chat UI → HTTP API: sends chat requests
- Python SDK → HTTP API: calls API
python-sdk/remote_ai_access/client.py - Async SDK → HTTP API: calls API
python-sdk/remote_ai_access/async_client.py - HTTP API → Chat Context: resolves context
src/server.js - HTTP API → Provider Config: resolves credentials
src/server.js - HTTP API → Provider Retry: retries requests
src/server.js - HTTP API → AI Providers: proxies inference
README.md - HTTP API → Chat Job Queue: dispatches jobs
src/server.js - Chat Job Queue → Job Persistence: persists jobs
- User → File Lab: edits workspace
README.md - HTTP API → Workspace Search: searches workspace
src/server.js - HTTP API → Code Map: serves index
src/server.js - HTTP API → Git Snapshots: tracks file changes
src/server.js - HTTP API → File Sharing: serves shares
src/server.js - HTTP API → Chat Archive: stores archive
src/server.js - User → Audit Log: reviews operations
README.md - HTTP API → Activity Timeline: aggregates events
src/server.js - HTTP API → Recipe Schedules: schedules recipes
src/server.js - HTTP API → Subagent Policies: applies policies
src/server.js - HTTP API → Subagent Results: records results
src/server.js - HTTP API → Review Workflow: supports review
src/server.js - HTTP API → TDD Workflow: supports coding
src/server.js