pasika

Reusable agent setup package, starting with Claude.

pasika stores portable agent setup assets that individual repos can apply or adapt. Today it focuses on Claude, with room for Codex and other agent-specific setup flows later.

Scope

This repo intentionally starts narrow:

• Claude first for v1
• reusable agent setup assets only
• shared docs at the repo root
• no project-specific rules, workflows, or business logic

Layout

claude/
  settings.base.json
  hooks/
    status-line/
      index.js
    notification.sh
    protect-files.sh
  scripts/
    render-settings.ts
docs/
  claude/
    hooks.md
scripts/
  pasika.ts
dist/
  ...
vulyk.json
AGENTS.md
CLAUDE.md

What belongs here

• portable setup scripts
• base settings templates
• shared docs and generated CLAUDE.md
• shared naming and layout conventions

What stays in project repos

• final agent config folders in project repos
• project-specific rules, agents, and prompts
• repository-specific plugin choices
• scripts that depend on a specific app, CI setup, or codebase

CLI

The current entry point is:

npx pasika claude

Optional flags:

• --target-dir <path> writes into another repo
• --force replaces an existing generated file instead of merging

Development

The CLI source lives in TypeScript.

npm run lint
npm run typecheck
npm run build

npm run build uses vulyk docs to emit root AGENTS.md and CLAUDE.md.

Recommended Integration

Hooks and helper executables should come from node_modules.

That gives us:

• versioned reusable scripts
• easy upgrades through the package manager
• no manual copying of hook files into every repo

settings.json is different. It still needs to exist in each project repo, because Claude Code does not give us a clean inheritance model for it.

So the recommended pattern is:

1. install pasika as a dev dependency
2. run npx pasika claude
3. generate or merge into .claude/settings.json in the project
4. point hook commands at ./node_modules/pasika/claude/...
5. keep project-specific plugin, skill, and rule decisions in the project repo

npx pasika claude also copies the packaged Claude hooks docs into .claude/hooks/ in the target repo.