gognitive

Gognitive is a Go client for the Limitless AI Pendant API, providing typed access to lifelog data for analysis, archiving, or intelligent retrieval.

🧠 Designed for developers building lifelogging tools, personal knowledge bases, or RAG systems.

---

✨ Features

• Authenticate and connect to the Limitless API
• List and filter lifelogs with full pagination support
• Fetch individual lifelogs by ID
• Work with structured data (timestamps, blockquotes, speakers, headings)
• Export-ready integration with CLI and automation tools

---

🚀 Installation

go get github.com/sottey/gognitive

If you're contributing or using locally:

replace github.com/sottey/gognitive => ../gognitive

---

🧱 Client API

client := gognitive.NewClient("sk-your-api-key")

Available Methods

ListLifelogs(limit int, cursor, date, start, end, timezone string) ([]Lifelog, string, error)

GetLifelog(id string) (*Lifelog, error)

---

🔡 Types

type Lifelog struct {
	ID        string
	Title     string
	Markdown  string
	Contents  []ContentNode
	StartTime string
	EndTime   string
}

type ContentNode struct {
	Type              string
	Content           string
	StartTime         string
	EndTime           string
	SpeakerName       *string
	SpeakerIdentifier *string
	Children          []ContentNode
}

---

🧪 Example CLI: relifevc

A real-world CLI app using gognitive is included in the example/relifevc directory.

Usage

cd example/relifevc
go run main.go list --limit 5

Or build it:

go build -o relifevc
./relifevc list --limit 5
./relifevc export --save --all --format=json --dir=./backups

Config

Create ~/.relifevc/config.json:

{
  "api_key": "sk-xxx",
  "timezone": "America/Los_Angeles",
  "export": {
    "format": "json",
    "dir": "./exports"
  }
}

---

📦 Roadmap

• POST/annotation support (if the API expands)
• Rate limiting + retry middleware
• Built-in local indexer for RAG-ready storage

---

🛡 License

MIT © 2025 Sean Ottey

---

🙋‍♂️ Questions?

Open an issue, fork the repo, or build something awesome with your lifelogs.