How omeryasirkucuk/amx works
AMX drafts database comments by combining live schema/profile evidence, retrieved documentation, and code references; an orchestrator ranks suggestions for human review before approved text is applied as native database comments. Users can run this workflow through the CLI or Studio. The repository also includes search/Ask, lineage, generated documentation pages, scheduling, and IDE integrations. Edges follow README-described behavior or relationships visible in the supplied source index and excerpts; unsampled subsystem wiring is not inferred.
Main entry points: orchestrator.py Run orchestrator · provider.py LLM provider · code_agent.py Code agent · cli.py CLI session
Components 32
Comment generation
- Run orchestrator
amx/agents/orchestrator.py - Profile agent
amx/agents/profile_agent.py - RAG agent
amx/agents/rag_agent.py - Code agent
amx/agents/code_agent.py - Agent types
amx/agents/base.py - LLM provider
amx/llm/provider.py - LLM batch
amx/llm/batch.py
Data and retrieval
- Configuration
amx/config.py - Database connector
amx/db/connector.py - Database adapters
amx/db/adapters/base.py - Code analysis
amx/codebase/analyzer.py - Code retrieval
amx/codebase/code_rag.py - Search catalog
amx/search/catalog.py - Search index
amx/search/index.py - Documentation retrieval
amx/agents/rag_agent.py - Optional dependencies
amx/utils/optional_deps.py
Review and history
- Local history store
amx/storage/sqlite_store.py - Pending review
amx/pending_review.py - Human review
amx/agents/_orchestrator/review.py
User interfaces
- CLI session
amx/cli.py - Studio server
amx/web/server.py - Studio UI
frontend/src/App.tsx - Console output
amx/utils/console.py - Live display
amx/utils/live_display.py - Structured logging
amx/utils/logging.py
Additional capabilities
- Lineage service
amx/lineage/service.py - Page generation
amx/pages/service.py - Scheduled runs
amx/scheduler/tick.py - Scheduled worker
amx/runtime/worker.py - VS Code extension
vscode-extension/src/extension.ts - MCP server
amx/mcp/server.py
Other components
- User
Connections 38
- User → CLI session: starts run
README.md - User → Studio server: opens Studio
README.md - Studio UI → Studio server: calls API
- CLI session → Run orchestrator: starts generation
README.md - Studio server → Run orchestrator: generates suggestions
- Run orchestrator → Profile agent: gathers evidence
README.md - Run orchestrator → RAG agent: gathers evidence
README.md - Run orchestrator → Code agent: gathers evidence
README.md - Run orchestrator → Database connector: profiles assets
amx/agents/orchestrator.py - Run orchestrator → Agent types: uses suggestion types
amx/agents/orchestrator.py - Profile agent → LLM provider: requests completion
- RAG agent → LLM provider: requests completion
- Code agent → LLM provider: requests completion
amx/agents/code_agent.py - Code agent → Code analysis: finds references
amx/agents/code_agent.py - Code agent → Code retrieval: retrieves code context
amx/agents/code_agent.py - Database connector → Database adapters: uses backend adapter
amx/db/connector.py - Run orchestrator → Human review: ranks and reviews
README.md - Human review → User: presents suggestions
README.md - User → Human review: accepts or edits
README.md - Human review → Database connector: applies approved comments
README.md - Run orchestrator → Local history store: records run history
README.md - Pending review → Local history store: reads and updates history
amx/pending_review.py - CLI session → Console output: renders prompts
- CLI session → Live display: shows progress
- Run orchestrator → Configuration: reads configuration
amx/agents/orchestrator.py - LLM provider → Configuration: uses provider settings
amx/llm/provider.py - Search catalog → Local history store: opens history store
amx/search/catalog.py - Search catalog → Search index: uses index
amx/search/catalog.py - User → Search catalog: searches catalog
- User → Lineage service: explores lineage
- User → Page generation: creates documentation pages
- Scheduled runs → Scheduled worker: spawns scheduled run
amx/runtime/worker.py - Scheduled worker → Run orchestrator: executes scheduled run
amx/runtime/worker.py - User → VS Code extension: uses IDE integration
- User → MCP server: connects MCP client
- LLM provider → LLM batch: submits batch requests
amx/llm/provider.py - Run orchestrator → Structured logging: logs run activity
amx/agents/orchestrator.py - Code analysis → Optional dependencies: checks optional packages
amx/codebase/analyzer.py