nikzlabs

nikzlabs/shipit

Settings file Claude Code

Agent settings declaring 2 allowed tools.

nikzlabs/shipit

Skill Claude CodeCodex

Step-by-step guide for adding new server functionality to ShipIt: HTTP endpoints (service -> route -> client hook -> test), WebSocket messages (type -> handler -> dispatcher -> client), deploy targets, tool activity labels, and the WebSocket vs HTTP decision framework. Load when adding a new API endpoint, WS message…

nikzlabs/shipit

Skill Claude CodeCodex

Build, test, debug, and preview Android apps inside a ShipIt session. Load when a task touches an Android/Gradle project (Kotlin/Java, build.gradle(.kts), AndroidManifest.xml, res/ layouts, Compose UI). Covers the baked toolchain (JDK/SDK/Gradle), the build → lint → snapshot-test loop, reading snapshot PNG diffs…

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt React client architecture: Zustand stores, communication hooks (useApi, useSessionWebSocket, useServerEvents, useMessageHandler), component inventory, data flow patterns. Load when working on frontend components, stores, hooks, or client state.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt deployment architecture: auto-deploy on push via platform Git integration, GitHub Deployments API for status tracking, deployment status in PR lifecycle card. Load when working on deployment features.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt design language: color tokens, typography, iconography, motion, and multi-theme architecture. Load when working on UI components, styling, theming, or adding new visual elements.

nikzlabs/shipit

Skill Claude CodeCodex

Feature docs index, navigation, and authoring: find how a feature was implemented, check what's planned/in-progress, and get the docs/NNN- folder layout, frontmatter schema (issue/title/description), issue-pointer syntax, and committed-prototype conventions. Load when reading or writing any docs/ feature doc. Not…

nikzlabs/shipit

Skill Claude CodeCodex

Running ShipIt inside ShipIt: the manual dev Compose preview, the inner orchestrator's RUNTIMEMODE=local limitations, which credentials to set (and which to leave unset), repo seeding, and driving the inner instance over its HTTP API. Load when working on the dogfood loop, debugging the inner ShipIt UI, or touching…

nikzlabs/shipit

Skill Claude CodeCodex

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt git architecture: GitManager (per-session), RepoGit (shared bare cache + per-session local clones), credential setup, auto-commit flow, session clone lifecycle, branch naming. Load when working on git operations, the bare cache, per-session clones, credentials, or repo management.

nikzlabs/shipit

Skill Claude CodeCodex

How ShipIt stores and composes LLM prompts: prompt text as .md data files loaded at module top level, composition in TypeScript, the byte-stability prompt-cache contract, and how to test prompts (composition and caching, never literal wording). Load when editing agent system instructions, voice cleanup, session…

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt server/orchestrator architecture: buildApp(), HTTP API routes, services layer, WebSocket handler dispatch, SSE broadcasts, dependency injection, state scopes, manager initialization, type system. Load when working on orchestrator code, routes, services, or WebSocket handlers.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt Docker container and session runner architecture: ContainerSessionRunner, SessionRunnerRegistry, container creation/destruction, health monitoring, idle container disposal, reconnection after disposal, graceful shutdown. Load when working on containers, runners, idle cleanup, or container debugging.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt session lifecycle: session types (standalone, repo-backed, warm), creation paths, warm session pool mechanics, session activation flow, session switching. Load when working on session creation, warm pool, or activation logic.

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt session worker processes: Claude CLI spawning and NDJSON parsing, agent abstraction (AgentProcess, ProxyAgentProcess), Docker Compose services (ServiceManager), file watcher, terminal PTY, session worker endpoints. Load when working on Claude process management, compose services, file watcher, terminal, or…

nikzlabs/shipit

Skill Claude CodeCodex

ShipIt testing conventions and quality checklist: Vitest config (server vs client), server test patterns (temp dirs), integration tests (buildApp, TestClient, test-helpers.ts), client tests (render, renderHook, FakeWebSocket), mocking patterns, and the pre-completion quality checklist (input validation, component…

nikzlabs/shipit

Instructions file CodexOpenCode

Instructions for nikzlabs/shipit, a project described as: Self-hosted, chat-driven IDE for running coding agents through your real engineering loop — Claude Code or Codex, parallel sandboxed containers, live preview, and the GitHub loop inline.

nikzlabs/shipit

Instructions file

Instructions for nikzlabs/shipit, covering claude.md, product principles, 1. shipit is the surface. the user does not leave it, 2. inline beats link-out. always and 5. chat is the input surface. the agent is the actor.

nikzlabs/shipit

Skill Claude CodeCodex

How to run the test-plugin probe and read its report — which field verifies which part of the docs/262 plugin usage contract.