Skip to content

About

Native macOS app for capturing thoughts, planning with project context, launching CLI agents, and journaling decisions.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ContextDock

A native macOS app for developers to capture a thought, match it to project context, choose a plan, and launch a coding agent from a notch-style panel.

What it does

  • Opens a floating island with Option+Space, with a fallback layout for displays without a notch.
  • Produces Recommended, Fastest, and Safest plans using an available Claude Code/Codex CLI or local rules.
  • Launches CLI tasks with a context package and displays agent events.
  • Tracks decisions and preferences in local storage.
  • Includes an Obsidian note writer with atomic writes and revision backups.
  • Accepts events through a local Unix socket and includes a demo event sender.

Project status

This is a Swift application under active development. Some adapters and controls are partial: CLI output becomes generic events, attaching to an arbitrary existing session is incomplete, and the adapter cancellation method is currently empty. Documentation includes older limitation notes that may lag the code.

Built with

Swift 6, SwiftUI, AppKit, Swift Package Manager, and Swift Testing. No external Swift package dependencies are declared.

How it works

A captured thought is matched to the configured project context and passed to the planner. The chosen plan becomes a task package for a CLI adapter. A local socket carries agent events back to the panel and journal; the Obsidian writer can save notes to the configured vault.

Getting started

The app targets macOS 15 or later. Building it requires Xcode 26 or a compatible Swift 6 toolchain with the macOS 26 SDK and macro plugins, because the UI includes newer glass APIs behind runtime availability checks. Full Xcode can open Package.swift; CI uses Xcode 26.3.

git clone https://github.com/wtfashwin/ContextDock.git
cd ContextDock
./scripts/make_app.sh

Launching the app currently installs hooks automatically before onboarding. It writes scripts under ~/.contextdock/bin/ and merges hook entries into ~/.claude/settings.json. Repeated installation keeps existing user settings and avoids duplicate managed commands. Malformed settings are left unchanged. Review the installer and back up existing Claude settings before the first launch.

open build/ContextDock.app

The build script creates an app bundle and attempts local ad-hoc signing. It does not produce a notarized distribution.

Install and authenticate a supported agent CLI separately if you want AI planning or task dispatch. Without an available Claude Code/Codex CLI, planning falls back to local rules.

Use it

Press Option+Space, enter a thought, choose a plan, and review its checklist and task package before dispatch. Configure the project and optional Obsidian vault in the app. Agent activity appears in the island and local journal.

Planning itself can call an installed Claude Code or Codex CLI. That CLI may send the request, matched context, and learned preferences to its provider before task dispatch. Review the provider account and its data handling before using sensitive project context. Local storage does not mean every planning path is offline.

Structure and documentation

Path Purpose
Sources/ContextDockApp/ SwiftUI views and AppKit panel
Sources/ContextDockKit/ Planning, adapters, events, storage, and notes
Tests/ContextDockKitTests/ Core test suite
scripts/make_app.sh Build the app bundle
scripts/fake_events.py Demo socket events

See architecture, Claude adapter notes, Codex adapter notes, and contributing. Older privacy and limitation notes should be read alongside the current source.

Available checks

From the repository root with Xcode 26 selected:

swift build
swift test

For Command Line Tools, ./scripts/test.sh adds framework search paths. If the compiler reports missing TestingMacros or SwiftUIMacros, check that the active toolchain and SDK are compatible; full Xcode is the supported CI path.

Swift checks build the package and run the tests on macOS for source changes. Hook tests use temporary settings and a local socket, including the generated Python sender. They do not launch the app, change your Claude settings, or call an agent provider. Package checks do not establish UI behavior or external CLI compatibility.

To stop the running app, use its app controls or, from a terminal, pkill -x ContextDock.

License

MIT.

About

Native macOS app for capturing thoughts, planning with project context, launching CLI agents, and journaling decisions.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages