mcpField
O
openwork-core

openwork-core

github.com/different-aiDevelopment24.3k546 installsUpdated today
Repository

About openwork-core

openwork-core is a development skill for working on OpenWork, covering project orientation, OpenCode integration, and desktop and mobile development workflows. It emphasizes staying within OpenCode's tool surface and making plans, permissions, and progress visible.

Key features

  1. 01Project setup and orientation guidance
  2. 02OpenCode CLI and database reference
  3. 03Tauri desktop and mobile workflows
  4. 04UI and system-access guidelines

Use cases

  1. 01Getting oriented before changing OpenWork
  2. 02Developing the desktop or mobile app
  3. 03Inspecting OpenCode sessions and tool calls

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/different-ai/openwork --skill openwork-core

After installing, type/openwork-corein Claude Code to confirm it loaded.

Details

From the project README

Quick Usage (Already Configured)

Orientation
  • Read AGENTS.md, VISION.md, PRINCIPLES.md, PRODUCT.md, and ARCHITECTURE.md before changing behavior.
  • Ensure vendor/opencode exists for self-reference.
  • Use the tauri-solidjs skill for stack-specific guidance.
Update the OpenCode mirror
git -C vendor/opencode pull --ff-only
Development workflow
pnpm tauri dev          # Desktop development
pnpm tauri ios dev      # iOS development
pnpm tauri android dev  # Android development

# Or run directly in the desktop package:
pnpm -C packages/desktop tauri dev

OpenCode Integration

Spawn OpenCode CLI
opencode -p "your prompt" -f json -q
Read OpenCode database
~/.opencode/opencode.db  # SQLite database
Key tables
  • sessions — Task runs
  • messages — Chat messages and tool calls
  • history — File change tracking

Common Gotchas

  • OpenWork must stay within OpenCode's tool surface; avoid inventing new capabilities.
  • Always expose plans, permissions, and progress for non-technical users.
  • Use Tauri commands for all system access (file, shell, database).
  • Keep UI at 60fps; avoid blocking the main thread.
  • Mobile builds require platform-specific setup (Xcode, Android Studio).

UI Principles

  • Slick and fluid: animations, transitions, micro-interactions.
  • Mobile-first: touch targets, gestures, adaptive layouts.
  • Transparency: show plans, steps, and tool calls.
  • Progressive disclosure: hide advanced controls until needed.

First-Time Setup (If Not Configured)

Clone the OpenCode mirror
git clone https://github.com/anomalyco/opencode vendor/opencode
Initialize Tauri project
pnpm create tauri-app . --template solid-ts
Add mobile targets
pnpm tauri ios init
pnpm tauri android init

Common Gotchas

  • OpenWork must stay within OpenCode’s tool surface; avoid inventing new capabilities.
  • Always expose plans, permissions, and progress for non-technical users.

First-Time Setup (If Not Configured)

Clone the OpenCode mirror
git clone https://github.com/anomalyco/opencode vendor/opencode

Comments

Markdown supported