fulling

What it is

Fulling is building dedicated AI workspaces that combine skills, files, memory, scripts, and runtime. The current foundation provides identity and Kubernetes credential boundary functionality, with PostgreSQL-backed users, provider accounts, and sessions, plus a protected application workspace entry and per-user kubeconfig boundary.

How it works

• It uses GitHub sign-in via Better Auth, stores credentials and sessions in PostgreSQL, and enforces a user-scoped Kubernetes client boundary via a kubeconfig model.
• The repository targets a v3 foundation for workspace boundaries and credential isolation, including plaintext kubeconfigs stored in PostgreSQL and read-access controls.
• Development commands expose standard npm scripts for running, building, linting, testing, and Prisma migrations.

Getting started

• Requirements: Node.js 24, including its bundled npm 11.
• Local development (public app with sign-in disabled):

  npm ci
  npm run dev
  

• For legacy authenticated workspace (requires PostgreSQL and GitHub OAuth):

  cp .env.template .env.local
  # Fill in the database, Better Auth, and GitHub values.
  npm run prisma:migrate
  npm run dev
  

• Configure GitHub OAuth callback:

  ${BETTER_AUTH_URL}/api/auth/callback/github
  

• Key commands:

  npm run dev              # Start the development server
  npm run build            # Generate Prisma client and build
  npm run lint             # Run ESLint
  npm test                 # Run Vitest
  npm run test:e2e         # Run Playwright
  npm run prisma:format    # Format the Prisma schema
  npm run prisma:validate  # Validate the Prisma schema
  npm run prisma:migrate   # Deploy the baseline migration
  

Recent releases

• v2.0.0 Fulling v2.0.0 (2026-05-11): Fulling v2.0.0 release snapshot for the v2 control-plane work. This release stabilizes the current agentic sandbox and does not claim the full future platform surface.
• v1.0.0 MVP Release (2026-01-30): MVP release indicating core concept as an AI-driven full-stack engineer agent that works.

Traction

• Stars: 2439
• Forks: 231
• Open issues: 13

Behind the repo

• Topics include ai-agent, claude, claude-code, docker, kubernetes, llm, nextjs, pgsql, postgresql, prisma, react, shadcn-ui, typescript, vibe-coding
• Language: TypeScript
• License: MIT
• Created: 2025-10-11
• Last push: 2026-07-27

Caveats

• Requires Node.js 24 with npm 11; the public app does not require PostgreSQL or an OAuth provider, while legacy authentication requires PostgreSQL and a GitHub OAuth App.
• The README notes a v3 foundation and cautions that the v2 deployment should be reset for a new database when running migrations.