[Beta]

Research toolkit for human + AI agent workflows

A Python library that gives AI agents a reliable, deterministic interface to build and maintain a research library. Two layers: a reference store for epistemic objects, and a knowledge layer of synthesis notes, concept pages, and reading paths derived from them. Local-first, no GUI, no human workflows.

Use AI agents confidently [agent-native-functions]
Increase reference quality [CSL-JSON · two-stage-model]
Explore and filter readings [staging → library]
Turn a library into living understanding [wiki · synthesis-notes · concept-pages]
Work offline, own your library [local-first · portable · no-GUI]
Get started GitHub

Get started

No terminal required. Download the binary, upload it to your Co-Work session, and paste the setup prompt — your agent does the rest.

01

Download the binary for your platform

lore CLI
02

Place the binary in your collection folder, then upload it to your Claude Co-Work session.

03

Copy and paste this prompt into your Co-Work session


                  
                

              

            


          


          
            Full setup guide →
          
        

      


      
      

        

          
Research workflow — core

          


            

              01
              
Extract

              

                human
                "Pull the metadata from this PDF"
              

              

                agent
                Got it — title, authors, year, DOI extracted locally. No network needed.
              

              

                cli
                lore extract paper.pdf
              

            


            

              02
              
Stage

              

                human
                "Hold this for review — don't commit yet"
              

              

                agent
                Saved to staging with the file attached. Nothing in the library yet.
              

              

                cli
                lore staging stage '<json>' --file paper.pdf
              

            


            

              03
              
Merge

              

                human
                "These look good — add them to the library"
              

              

                agent
                Done. Duplicates removed, citekeys assigned, files archived.
              

              

                cli
                lore staging merge
              

            


            

              04
              
Search & Filter

              

                human
                "What do I have on boundary objects from 2019?"
              

              

                agent
                3 references. star1989 has a file attached — want me to open it?
              

              

                cli
                lore refs filter --query "boundary objects" --year 2019
              

            


            

              05
              
Files

              

                human
                "Attach this PDF to the reference"
              

              

                agent
                PDF archived under vaswani2017. Linked and ready to read.
              

              

                cli
                lore files attach vaswani2017 paper.pdf
              

            


          

        

      


      
      

        

          
Envisioned — not built yet

          

            

              Generate synthesis notes across your collection
              [synthesize · arguments · tensions · open-questions]
            

            

              Extend the core with search, cloud, and sync adapters
              [plugin-ecosystem · loretools-search · loretools-cloud · loretools-sync]
            

            

              Build a living wiki from your library
              [wiki · concept-pages · linked-to-citekeys]
            

            

              See how ideas connect and where the gaps are
              [citation-graph · influence-chains · gap-detection]
            

            

              Sync and curate a library with your team
              [multi-device · shared-collections · peer-coordination]
            

            

              Get curated reading paths across your collection
              [reading-paths · importance-scoring · progressive-disclosure]
            

          

        

      


      
      

        

          

            Beyond the reference
          

          

            We envision a transition from isolated reference metadata to shared epistemic objects that enable deeper
            conversations.