Skip to content

geoffjay/persona

Repository files navigation

Release

Persona

A framework for stateful AI-assisted conversations with persistent memory. Combines Claude Code personas with Berry's vector-searchable memory to enable context-aware mentoring and professional development guidance across multiple sessions.

Overview

This project demonstrates how persistent memory can augment specialized AI personas to create continuous, accountable collaboration. Rather than starting each AI session from scratch, Persona maintains context about previous discussions, decisions, assignments, and follow-ups.

Key Features

  • Custom AI Personas: System prompts that transform Claude into specialized roles (e.g., Staff Trajectory Mentor)
  • Persistent Memory: Vector-searchable context via Berry MCP integration
  • Session Continuity: Hooks that automatically retrieve prior context at session start
  • Assignment Tracking: Structured memory types for questions, requests, and information

Getting Started

Prerequisites

Installation

There are multiple ways to install most of the dependencies, this is just one example for macOS only:

brew install opencode
brew install geoffjay/tap/berry
brew install --cask geoffjay/tap/persona

Fix macOS Verification

Installing this on a macOS system requires a verification step, which can be skipped by running the following command:

xattr -rd com.apple.quarantine /Applications/Persona.app

Setup

ChromaDB

The persona project uses Berry to manage context, and Berry requires a Chroma database to store the context. You can either use a local database or a cloud-hosted database, using a cloud database is probably the easiest way to get started with a persistent database. This can be created at trychroma.com.

If you choose to use a cloud database, the environment variables for the database need to be setup before starting. Edit the file /opt/homebrew/etc/persona/server.env and ensure the following changes are made:

# Local ChromaDB (comment out for cloud)
# CHROMA_PROVIDER=local
# CHROMA_URL=http://localhost:8000

# Cloud ChromaDB
CHROMA_URL=https://api.trychroma.com
CHROMA_PROVIDER=cloud
CHROMA_API_KEY=<key-from-chroma>
CHROMA_TENANT=<tenant-from-chroma>
CHROMA_DATABASE=berry
CHROMA_COLLECTION=memories

Berry

brew services start geoffjay/tap/berry
curl http://localhost:4114/health

OpenCode

The persona user interface only supports OpenCode at this time, for it to work you need to authenticate with one of the OpenCode providers. Instructions on doing this are available at opencode.ai, but typically this only involves executing the command opencode auth login and following the prompts for the desired provider.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published