How yourikka/go_agent works
AI Agent Stack provides a browser extension backed by a REST gateway and RPC services for agent execution, retrieval-augmented memory, summarization, and configuration. The principal flow is a user query through the extension and gateway to the agent workflow, which can use RAG and summary services before returning an answer. The README documents additional document and memory administration features. Some subsystem links reflect documented architecture because their implementation was not sampled.
Main entry points: routes.go REST gateway · ragserver.go RAG service · chroma.go RAG repository · runlogic.go Agent service
Components 22
Client and gateway
- Browser extension
extension/src/popup.ts - REST gateway
gateway/internal/handler/routes.go - Agent API logic
gateway/internal/logic/agentrunlogic.go - RAG API logic
gateway/internal/logic/searchdocumentlogic.go - Summary API logic
gateway/internal/logic/summarylogic.go - Config API logic
gateway/internal/logic/configgetlogic.go
Agent workflow
- Agent service
apps/agent/internal/logic/runlogic.go - LangGraph workflow
apps/agent/langgraph/main.py - Chat model
apps/agent/langgraph/main.py
RAG and memory
- RAG service
apps/rag/internal/server/ragserver.go - Document ingest
apps/rag/internal/logic/adddocumentlogic.go - Hybrid retrieval
apps/rag/internal/logic/searchlogic.go - Memory feedback
apps/rag/internal/logic/feedbacklogic.go - RAG repository
apps/rag/internal/repository/chroma.go - Local memory store
apps/rag/internal/repository/sqlite.go - Chroma vector store
apps/rag/internal/repository/chroma.go
Summary and configuration
- Summary service
apps/summary/internal/logic/summarizelogic.go - Summary LLM client
apps/summary/internal/llm/client.go - Config service
apps/config/internal/logic/configlogic.go - Encrypted config store
apps/config/internal/store/store.go
Other components
- User
- OpenAI-compatible API
Connections 26
- User → Browser extension: submits query
- Browser extension → REST gateway: sends REST request
- REST gateway → Agent API logic: routes agent requests
- REST gateway → RAG API logic: routes RAG requests
- REST gateway → Summary API logic: routes summaries
- REST gateway → Config API logic: routes config requests
- Agent API logic → Agent service: calls RPC
- Agent service → LangGraph workflow: posts workflow request
- LangGraph workflow → Chat model: classifies and answers
- Chat model → OpenAI-compatible API: requests completion
- Agent service → RAG service: calls retrieval RPC
- Agent service → Summary service: calls summary RPC
- RAG API logic → RAG service: calls RAG RPC
- Summary API logic → Summary service: calls summary RPC
- Config API logic → Config service: calls config RPC
- RAG service → Document ingest: dispatches ingest
- RAG service → Hybrid retrieval: dispatches search
- RAG service → Memory feedback: dispatches feedback
- Document ingest → RAG repository: writes documents
- Hybrid retrieval → RAG repository: searches memories
- Memory feedback → RAG repository: updates memory weights
- RAG repository → Local memory store: reads and writes
- RAG repository → Chroma vector store: vector search
- Summary service → Summary LLM client: summarizes content
- Summary LLM client → OpenAI-compatible API: requests completion
- Config service → Encrypted config store: reads and writes