Configuration

PATAPIM configuration is managed through multiple files and environment variables.

Project-Level Configuration

.patapim/config.json

Project-specific configuration stored in .patapim/config.json at the project root.

{
  "projectName": "My Project",
  "defaultTerminalCount": 2,
  "historyFile": ".patapim/history.txt",
  "taskFile": "tasks.json"
}

Location: <project-root>/.patapim/config.json

Common Options:

Workspace Configuration

workspace.json

Global workspace configuration tracks open projects and window state.

Location: ~/.patapim/workspace.json (user home directory)

{
  "projects": [
    {
      "path": "/Users/username/project1",
      "lastOpened": "2026-02-06T10:30:00Z"
    }
  ],
  "recentProjects": [
    "/Users/username/project1",
    "/Users/username/project2"
  ],
  "windowState": {
    "width": 1200,
    "height": 800,
    "x": 100,
    "y": 100
  }
}

This file is automatically managed by PATAPIM and should not be edited manually.

Environment Variables

PATAPIM_DEBUG

Enable development tools for debugging.

# Windows (PowerShell)
$env:PATAPIM_DEBUG=1
.\node_modules\electron\dist\electron.exe .

# Linux/macOS
PATAPIM_DEBUG=1 electron .

When enabled:

• DevTools panel opens automatically
• Console logging is more verbose
• Error messages include stack traces

PATAPIM_AUTH_SECRET

Authentication secret for remote access (future feature).

export PATAPIM_AUTH_SECRET="your-secret-key"

PATAPIM_MCP_TOKEN

Authentication token for the MCP browser control REST API.

# Auto-generated on startup — typically not set manually
echo $PATAPIM_MCP_TOKEN

This token is generated automatically when PATAPIM starts and is injected into Claude Code and other AI CLI tools for MCP authentication. You generally don’t need to set this manually.

Runtime Settings (localStorage)

PATAPIM stores user preferences in the browser’s localStorage:

These are set through the UI and persist across sessions.

Configuration Files

Account & Auth Files

These files are managed automatically by PATAPIM. Manual editing is not recommended.

Configuration Priority

PATAPIM follows this priority order:

1. Environment variables (highest priority)
2. Project-level config (.patapim/config.json)
3. Workspace config (~/.patapim/workspace.json)
4. Runtime settings (localStorage)
5. Default values (hardcoded)

Example: Complete Setup

# 1. Create project config
mkdir .patapim
echo '{
  "projectName": "My App",
  "defaultTerminalCount": 2
}' > .patapim/config.json

# 2. Set environment variable
export PATAPIM_DEBUG=1

# 3. Launch PATAPIM
electron .

Configuration Files Location Summary