looplia init

The init command sets up your Looplia workspace at ~/.looplia/ with all required plugins and workflows.

Usage

looplia init [options]

Options

Option	Description
`--yes`, `-y`	Skip confirmation prompts

What It Does

The init command:

Creates the workspace directory at ~/.looplia/
Downloads default marketplaces from GitHub:
- Anthropic anthropic-agent-skills (42+ skills)
- ComposioHQ awesome-claude-skills (14+ skills)
Installs built-in plugins:
- looplia-core — Infrastructure plugin with commands and executor
- looplia-writer — Domain plugin with content analysis skills
Compiles skill catalog to ~/.looplia/registry/skill-catalog.json
Extracts workflows to ~/.looplia/workflows/
Creates configuration files for user profile and provider settings

Examples

# Interactive initialization
looplia init

# Non-interactive (skip prompts)
looplia init --yes

Workspace Structure

After initialization:

~/.looplia/
├── registry/                     # Skill Registry (v0.7.0)
│   ├── skill-catalog.json        # Compiled skill catalog
│   └── sources.json              # Configured marketplace sources
│
├── looplia-core/                 # Infrastructure plugin
│   ├── .claude-plugin/
│   │   └── plugin.json           # Plugin manifest
│   ├── CLAUDE.md                 # Plugin instructions
│   ├── commands/
│   │   ├── run.md                # /looplia:run command
│   │   └── build.md              # /looplia:build command
│   ├── skills/
│   │   ├── workflow-executor/
│   │   ├── workflow-validator/
│   │   └── registry-loader/      # NEW in v0.7.0
│   └── hooks/
│       └── session-logger.md
│
├── looplia-writer/               # Domain plugin
│   ├── .claude-plugin/
│   │   └── plugin.json
│   └── skills/
│       ├── media-reviewer/
│       ├── idea-synthesis/
│       └── writing-kit-assembler/
│
├── plugins/                      # Third-party plugins (v0.7.0)
│   ├── document-skills/          # xlsx, pdf, docx, pptx
│   ├── example-skills/           # frontend-design, algorithmic-art
│   └── ...                       # From ComposioHQ
│
├── workflows/                    # Workflow definitions
│   └── writing-kit.md
│
├── sandbox/                      # Execution sandboxes (preserved)
├── user-profile.json             # User preferences (preserved)
└── looplia.setting.json          # Provider config (preserved)

Re-initialization

Run init again to update plugins to the latest version:

# Update plugins (will overwrite existing)
looplia init --yes

Your sandboxes, user profile, and provider settings are not overwritten.

Troubleshooting

Permission Denied

If you see permission errors:

# Check directory permissions
ls -la ~/.looplia/

# Fix ownership if needed
sudo chown -R $(whoami) ~/.looplia/

Plugin Load Errors

If plugins fail to load after init:

# Remove and reinitialize
rm -rf ~/.looplia/looplia-core ~/.looplia/looplia-writer
looplia init --yes