How alharkan7/beeblio-oss works
Beeblio is a local-first AI research workspace: users link an existing folder, work with its files and research materials, and collaborate with Eve in project conversations. The session page joins workspace and conversation; the agent can research and edit files, while the editor supports citation-aware writing and exports. Project records, sessions, knowledge metadata, and share records live in SQLite; project documents remain in the linked folder. The README documents several capabilities whose detailed implementation was not sampled, so those branches are included at the documented subsystem level rather than with speculative call chains.
Main entry points: workspace-files.ts Workspace file access · tools Agent tools · page.tsx Project session · route.ts Eve request proxy
Components 26
Projects and workspace
- Project dashboard
app/_components/projects-dashboard-client.tsx - Project setup
app/api/projects/route.ts - Project session
app/[projectId]/[[...sessionId]]/page.tsx - File explorer
app/[projectId]/_components/file-explorer.tsx - Research artifacts
app/[projectId]/_components/research-artifact-browser.tsx - Workspace uploads
app/api/workspace/upload-ticket/route.ts - Storage meter
app/[projectId]/_components/storage-meter.tsx
Eve assistant
- Eve request proxy
app/eve/[...path]/route.ts - Eve agent
agent/agent.ts - Agent tools
agent/tools - Local commands
agent/sandbox
Research and knowledge
- Literature search
lib/literature/search.ts - Knowledge stores
lib/knowledge.ts - Bibliography
lib/project-bibliography.ts - Literature matrix
lib/literature-matrix.ts
Writing and sharing
- Markdown editor
app/[projectId]/_components/editors/tiptap-document-editor.tsx - Document review
app/[projectId]/_components/document-review-panel.tsx - Document export
lib/document-export/convert-latex.ts - Public sharing
app/share/[shareId]/page.tsx - Shared forms
lib/forms/runtime.ts
State and file access
- Application records
db/schema.ts - SQLite database
db/index.ts - Workspace file access
lib/workspace-files.ts - Agent token
lib/agent-token.ts
Other components
- Local user
- Model and research APIs
Connections 33
- Local user → Project dashboard: browses projects
README.md - Local user → Project setup: links folder
README.md - Project dashboard → Project session: opens project
README.md - Project setup → SQLite database: stores project
app/api/projects/route.ts - Project session → Eve request proxy: starts conversation
README.md - Project session → File explorer: opens workspace
README.md - Project session → Research artifacts: browses artifacts
README.md - Local user → Workspace uploads: uploads files
README.md - Workspace uploads → Workspace file access: creates ticket
app/api/workspace/upload-ticket/route.ts - Eve request proxy → Eve agent: forwards requests
app/eve/[...path]/route.ts - Eve request proxy → Agent token: mints token
app/eve/[...path]/route.ts - Eve request proxy → SQLite database: registers sessions
app/eve/[...path]/route.ts - Eve agent → Agent tools: uses tools
README.md - Eve agent → Local commands: runs workflows
README.md - Agent tools → Literature search: searches literature
README.md - Agent tools → Bibliography: updates references
README.md - Agent tools → Literature matrix: updates matrix
README.md - Agent tools → Workspace file access: edits project files
README.md - Local user → Markdown editor: writes documents
README.md - Markdown editor → Bibliography: inserts citations
README.md - Local user → Document review: requests review
README.md - Markdown editor → Document export: exports document
README.md - Local user → Literature search: searches sources
README.md - Local user → Knowledge stores: uses knowledge
- Local user → Public sharing: shares file
README.md - Public sharing → Shared forms: renders forms
- Public sharing → Workspace file access: reads shared files
app/share/[shareId]/page.tsx - Local user → Workspace file access: works with folder
README.md - Workspace file access → SQLite database: resolves projects
lib/workspace-files.ts - SQLite database → Application records: uses schema
db/index.ts - Storage meter → Workspace file access: requests usage
- Eve agent → Model and research APIs: calls model APIs
README.md - Literature search → Model and research APIs: queries research APIs