flight-portable

flight-portable

A lightweight AI work companion for non-technical users — a calm, capable assistant for analyzing documents, discussing topics, and producing precise written outputs, without the complexity of multi-agent orchestration.

This is a portable build of flight that runs in three places:

• Claude Code (CLI) — drop the skills/agent into a project's .claude/.
• Claude Cowork — same .claude/ layout in a connected project folder.
• Claude Desktop — upload the skills as ZIPs (Settings → Capabilities → Skills).

Its single AI agent is named pilot. Everything flight tracks is plain files in a flight-workbench/ folder inside the folder you connect — there is no MCP server and nothing system-wide.

Installing it? See INSTALL.md for the step-by-step guide (German, non-technical) covering both Cowork and Desktop.

What flight does

• Analyzes documents and discusses topics. Bring a PDF, a spec, a transcript — talk it through, get a summary, draft a response.
• Produces well-styled written outputs. Markdown by default; also .pptx, .xlsx, .docx, etc. on request. Documents apply a professional-voice stylometric profile; conversational replies apply a leaner chat-voice profile. Deliverables land at the connected-folder root, not inside flight-workbench/.
• Tracks open tasks in flight-workbench/memos/tasks-<user>.md — they show up automatically every session. (Not in CLAUDE.md, which is shared with other tools.)
• Files decisions when you ask (or when a discussion surfaces an insight worth keeping).
• Logs every session to flight-workbench/history/, so the conversation is durable even if you do not use git.

What flight is NOT

• Not a code-writing assistant primarily (though it can write code on request).
• Not fusion. No orchestrator, no Turn loops, no Coherence checks, no compliance guard, no sub-agent dispatch.
• Not silent. Flight asks before destructive operations.

Quick start

Install in one command — no GitHub account needed (adjust the folder path):

curl -fsSL https://raw.githubusercontent.com/DigitalLeadershipAG/flight-portable/portable/install.sh | bash -s -- /path/to/your/folder

This copies the skills into <folder>/.claude/skills/, the pilot agent into <folder>/.claude/agents/, the slash-command wrappers into <folder>/.claude/commands/, creates CLAUDE.md (only if missing — your edits are never overwritten), and prepares the Desktop ZIPs in <folder>/flight-desktop-skills/. Then just ask Claude to "start flight" (in Claude Code you can also type /flight-start).

• Cowork: connect the folder, then talk to Claude in natural language (no slash commands).
• Claude Desktop: upload the 8 ZIPs from flight-desktop-skills/ in Settings → Capabilities → Skills.
• All projects at once: ./flight-portable/install.sh --global installs into ~/.claude/, making flight available in every Cowork/Claude Code project (the workbench is still created per connected folder).
• Team sharing: install into a Dropbox-synced folder — flight-workbench/ (tasks, memos, history) and the .claude/ skills then sync to the whole team. See the "Team-Setup über Dropbox" section in INSTALL.md.

Full step-by-step guide: INSTALL.md.

Prefer a clone? gh repo clone DigitalLeadershipAG/flight-portable && ./flight-portable/install.sh /path/to/folder.

Alternative: install as a plugin (Claude Code — real slash commands)

install.sh copies the skills into a folder, where they auto-trigger (no slash commands). If you instead want real namespaced commands like /flight-portable:start, install it as a plugin via the bundled marketplace. This works in Claude Code and Cowork. Two steps — both are required:

/plugin marketplace add DigitalLeadershipAG/flight-portable   # 1) add the marketplace
/plugin install flight-portable@digitalleadership             # 2) install the plugin (don't skip this!)

After a reload you get /flight-portable:start, /flight-portable:memo, etc., plus a clean /plugin update path. (In the Cowork GUI: adding the repo only does step 1 — you must then pick flight-portable and click Install.) Claude Desktop has no plugins — there the uploaded skills auto-trigger instead.

The eight skills

In Claude Code (CLI) these are real slash commands (/flight-start, /flight-memo, …). In Cowork and Claude Desktop there are no slash commands — the skills trigger automatically from their description, so you just describe what you want ("merke dir …", "start flight"). A German phrasebook of what to say is in SPRACHBEFEHLE.md.