# puppyone-ai/puppyone

Context drive for your AI agents

Repository: https://github.com/puppyone-ai/puppyone
Canonical: https://ross.abutalabs.com/products/puppyone
Homepage: https://www.puppyone.ai
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: agent, agentic-ai, ai, ai-agents, context, context-engineering, rag, harness, harness-engineering
Last push: 2026-08-02T17:44:10+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 74, longevity 45
- inputs: {"age_days": 635, "days_push": 31, "days_rel": 94, "gap_med": 41.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1299, forks 74 (observed 2026-08-28T04:04:17.381715+00:00)

## What it is
Puppyone is a Git-native context drive for AI agents: a persistent, version-controlled file workspace with per-agent scoped permissions, exposed via MCP, CLI, Git, SSH, REST, and a web app. It can be self-hosted with Docker or used as a hosted cloud service, and mirrors SaaS data (Notion, Slack, Postgres, GitHub, etc.) as files agents can read and write.

## Use cases
- give AI agents persistent memory across sessions
- share context between multiple AI agents like Claude Code and Cursor
- mount Notion and Slack data as files for agents via MCP
- add durable version-controlled state to n8n workflows
- give LangChain or CrewAI agents a shared file workspace
- self-host a context store for AI coding agents
- give each agent scoped read/write permissions on shared files

## When to choose
- your agents lose context between sessions and you need durable, versioned shared state
- you run multiple agents or frameworks (Claude Code, Cursor, n8n, LangChain, CrewAI) that need to see the same files
- you want per-agent permissions, audit trails, and rollback on agent file edits
- you want SaaS data (Notion, Slack, Postgres) materialized as files agents can read

## When to avoid
- you only need a vector database for pure RAG similarity search
- you want a lightweight in-process memory library with no server to run
- your agents only work within a single repo and never need cross-session or cross-agent context

## Facets
- artifact type: service
- maturity: active
- function: mcp, rag, agent-framework, file-system, version-control, self-hosted, api-framework, webhook
- domain: developer-tools, large-language-models, self-hosted
- platform: self-hosted, cloud, cli
- tags: context-engineering, context-hosting, agent-memory, git-native, per-agent-permissions, saas-connectors, file-workspace, multi-agent-collaboration, ai-agents, retrieval-augmented-generation, web-server, docker, macos, nodejs

## Member repositories
- puppyone-ai/puppyone (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:17.381715+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:53:27.371586+00:00, confidence not recorded.
  - readme: https://github.com/puppyone-ai/puppyone (fetched 2026-08-28T04:04:17.381715+00:00, sha b23f2c7c9714)
  - homepage: https://www.puppyone.ai (fetched 2026-08-29T12:10:26.057113+00:00, sha 57d0dbe1ddc4)
  - site_page: https://www.puppyone.ai/en/integrations/claude-code (fetched 2026-08-29T12:10:26.059885+00:00, sha 01b30c03f3e1)
  - site_page: https://www.puppyone.ai/en/integrations/cursor (fetched 2026-08-29T12:10:26.061797+00:00, sha ef51351b0b0b)
  - site_page: https://www.puppyone.ai/en/integrations/mcp (fetched 2026-08-29T12:10:26.063657+00:00, sha 540599cbf78b)
  - site_page: https://www.puppyone.ai/en/integrations/n8n (fetched 2026-08-29T12:10:26.065377+00:00, sha a512dcac4445)
  - site_page: https://www.puppyone.ai/en/integrations/langchain (fetched 2026-08-29T12:10:26.067217+00:00, sha 46ebf7bb1eb9)
  - site_page: https://www.puppyone.ai/en/integrations/crewai (fetched 2026-08-29T12:10:26.069491+00:00, sha ec93441ffb78)
  - site_page: https://www.puppyone.ai/en/integrations (fetched 2026-08-29T12:10:26.071502+00:00, sha 3ba695b974b4)
  - site_page: https://www.puppyone.ai/en/changelog (fetched 2026-08-29T12:10:26.073325+00:00, sha 9f940e53c403)
- Data as of 2026-08-30T08:39:29.467469+00:00.