How bloopai/bloop works
bloop is a desktop and web-style code assistant for searching, understanding, and editing repositories. The main workflow is to add or sync repositories, index their source, then search or ask questions; results appear in file, documentation, chat, and Code Studio views, where users can generate patches. The backend also provides regex search, symbol search, code navigation, and on-device semantic search. The graph combines documented product capabilities with relationships visible in the sampled source and source index; several frontend-to-server and unsampled subsystem links are therefore omitted.
Main entry points: query.rs Query endpoint · src/App.tsx Client application · execute.rs Query execution · src/App.tsx Desktop host
Components 26
Client experience
- Client application
client/src/App.tsx - Command bar
client/src/CommandBar/index.tsx - Project workspace
client/src/Project/index.tsx - Tab state
client/src/context/providers/TabsContextProvider.tsx - Conversational search
client/src/Project/CurrentTabContent/ChatTab/index.tsx - Code Studio
client/src/Project/CurrentTabContent/StudioTab/index.tsx - Documentation view
client/src/Project/CurrentTabContent/DocTab/index.tsx - Regex search UI
client/src/Project/LeftSidebar/RegexSearchPanel/index.tsx - API client
client/src/services/api.ts
Repository indexing
- Repository management
server/bleep/src/repo.rs - Remote sync
server/bleep/src/remotes.rs - Source collector
server/bleep/src/collector.rs - Search indexes
server/bleep/src/indexes.rs - Persistent database
server/bleep/src/db.rs
Search and navigation
- Query endpoint
server/bleep/src/webserver/query.rs - Query parser
server/bleep/src/query/parser.rs - Query execution
server/bleep/src/query/execute.rs - Result ranking
server/bleep/src/query/ranking.rs - Code navigation
server/bleep/src/intelligence.rs - Semantic search
server/bleep/src/semantic.rs
AI assistance
- Answer and code agent
server/bleep/src/agent.rs - LLM client
server/bleep/src/llm/client.rs
Desktop runtime
- Desktop host
apps/desktop/src/App.tsx - Tauri commands
apps/desktop/src-tauri/src/main.rs - Qdrant supervisor
apps/desktop/src-tauri/src/qdrant.rs
Other components
- Engineer
Connections 26
- Engineer → Desktop host: uses
- Desktop host → Client application: hosts
apps/desktop/src/App.tsx - Desktop host → Tauri commands: invokes commands
apps/desktop/src/App.tsx - Tauri commands → Qdrant supervisor: registers plugin
apps/desktop/src-tauri/src/main.rs - Client application → Project workspace: renders
client/src/App.tsx - Client application → Command bar: renders
client/src/App.tsx - Project workspace → Tab state: uses tab state
client/src/Project/index.tsx - Engineer → Command bar: selects actions
- Engineer → Conversational search: asks questions
- Engineer → Code Studio: creates patches
- Engineer → Regex search UI: searches code
- API client → Query endpoint: requests search
- Query endpoint → Query execution: executes query
server/bleep/src/webserver/query.rs - Query execution → Query parser: parses query
server/bleep/src/query/execute.rs - Query execution → Result ranking: ranks results
server/bleep/src/query/execute.rs - Query endpoint → Persistent database: reads and logs
server/bleep/src/webserver/query.rs - Repository management → Source collector: iterates source
- Source collector → Search indexes: builds indexes
- Remote sync → Repository management: updates repositories
- Engineer → Remote sync: syncs repositories
- Engineer → Code navigation: navigates symbols
- Engineer → Semantic search: searches by meaning
- Conversational search → Answer and code agent: requests answers
- Code Studio → Answer and code agent: requests code
- Answer and code agent → LLM client: calls model
- Query endpoint → Search indexes: searches