Skip to content

pccly/claude-prefs-app

Repository files navigation

DevMind

A desktop app to manage skills, memories, and MCP plugins for AI coding tools across multiple workspaces and projects.

Companion GUI to claude-prefs-cli (ccp) - the same configuration files, managed visually.

Electron React TypeScript


What it manages

Memories (~/.claude/global-memory/, ~/.claude/projects/*/memory/) Persistent context files injected into every Claude Code session. Store your coding preferences, project-specific facts, and feedback patterns. Each file is Markdown with YAML frontmatter.

Skills (~/.claude/skills/, .claude/skills/ per-project) Reusable prompt instruction sets symlinked into projects. Examples: conventional-commit, api-design, code-review.

Plugins (.claude/mcp.json per-project) MCP (Model Context Protocol) server configurations. Each entry wires an external tool (database client, browser, file system) into your AI session.


Supported tools

Tool Config path
Claude Code ~/.claude/
Codex ~/.codex/
Cursor ~/.cursor/
Other Custom path

Data formats

Memory file (*.md)

---
name: Prefer pnpm
description: Always use pnpm over npm/yarn
type: feedback
---

Use pnpm as the default package manager for all installs and scripts.

**Why:** Faster installs, strict lockfile, disk-efficient.
**How to apply:** Replace npm/yarn commands with pnpm equivalents.

Memory types: feedback · user · project · reference

MCP plugin config (.claude/mcp.json)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

Skills

Symlinked Markdown files installed via ccp skills add or downloaded from skills.sh.


Workspace detection

On launch the app scans ~/.claude/projects/ and lists all known workspaces. Each subdirectory maps to a project path using Claude Code's encoding convention:

/Users/po/code4po/myapp  →  ~/.claude/projects/-Users-po-code4po-myapp/

Tech stack

Layer Library
Desktop shell Electron 33
UI framework React 19 + TypeScript
Styling Tailwind CSS v4
State Zustand v5
Build electron-vite 2
Packaging electron-builder

Project structure

src/
  main/
    index.ts          # Electron main process, window creation
    ipc.ts            # IPC handlers - all file system operations
  preload/
    index.ts          # Context bridge (exposes window.api to renderer)
    index.d.ts        # TypeScript types for window.api
  renderer/src/
    App.tsx           # Root component
    components/
      Sidebar.tsx           # Tool selector, workspace list, nav
      WorkspaceSelector.tsx # Workspace dropdown
      SkillsPanel.tsx       # List/add/remove skills
      MemoriesPanel.tsx     # File browser + markdown editor
      PluginsPanel.tsx      # MCP server list + add/remove
    store/
      app-store.ts    # Zustand store (active tool, workspace, section)
    types/
      index.ts        # AITool, Workspace, Plugin, NavSection

Development

pnpm install
pnpm dev          # Launch Electron with hot reload
pnpm typecheck    # TypeScript check
pnpm build        # Production build

Relationship to ccp CLI

DevMind is a GUI front-end for the same files that ccp manages from the terminal. Both tools read and write the same directories - you can use them interchangeably.

Operation CLI App
List memories ccp list Memories panel
Edit a memory $EDITOR ~/.claude/global-memory/file.md Inline editor
Add a skill ccp skills add Skills panel
Init a project ccp init Workspace + Skills panel
Add MCP server Manual JSON edit Plugins panel

Related

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors