Devcroft

Your personal development workspace

Devcroft is a GPUI based desktop app for personal development workflow. It focuses on keeping development workflow same no matter which harness you use. Vim like keyboard navigation let you fly between projects with ease.

Quickstart

Install or update the latest release with the same command (available after the first release is published):

curl -fsSL https://github.com/hossainemruz/devcroft/releases/latest/download/install.sh | bash

macOS users can alternatively install through our Homebrew tap once it is enabled:

brew install --cask hossainemruz/tap/devcroft
brew upgrade --cask devcroft

Packages support Linux x86-64 (Ubuntu 24.04 or compatible) and macOS 13+ (Intel and Apple Silicon). The installer verifies checksums, installs the desktop app and CLI, and preserves your app data. Add ~/.local/bin to your PATH for the CLI. Restart Devcroft after updating. Home shows a notice when a newer stable release is available. See installation, platform requirements, and publishing releases.

You need Git (git on the application PATH) and at least one agent harness (opencode, claude, codex, or omp) on your default shell's PATH. Optional: gh (authenticated) for PR tracking, Neovim if you prefer it as your editor.

Build from source

Install mise to manage the pinned Rust and Zig toolchains:

mise install
mise run build
mise run app

Install as the Devcroft desktop app:

mise run install          # release build; use --debug for a faster debug install

On Linux this installs ~/.local/bin/devcroft plus a devcroft.desktop launcher; on macOS it (re)creates /Applications/Devcroft.app (~/Applications fallback when /Applications is not writable). Your data in ~/.local/share/devcroft (device.json, portable/, caches) is kept. If the app ever aborts without a message, the report is written to logs/panic.log under the data root and is never synced.

Features

• Agent runs your default harness (opencode unless changed in Settings → Agent) in your default login shell, resuming the checkout's most recent session when history exists. Use New session to pick a harness explicitly.
• Git opens as a full workspace page from Open Git in the header's branch menu, Cmd/Ctrl+J, then g, or Open Git in the actions palette. Back returns to the previous view. Changes, History, branch management, remote operations, and conflict editing share this page; dialogs open above it. See Git workflow.
• Editor offers Neovim or the built-in editor (Settings → Editor; the default for new installations). The built-in editor covers file tabs, fuzzy finding, project search, syntax highlighting, and find/replace for small edits. See editor setup and everyday use and language support.
• Terminal tabs own independent PTY sessions backed by your login shell, with bundled Nerd Font symbols and mouse/link support. See Terminal.
• Home dashboard for recent projects, repository relationships, PRs, todos, and reading lists, partitioned by spaces. See Home dashboard.
• Review tab with syntax highlighting and persistent line/range comments, plus a headless CLI for agents. See review workflow and CLI.
• Resources tab for repository plans, RFCs, notes, reviews, and visual tutorials with agent-accessible comments. See Repository resources.
• Relationship graph to connect providers to consumers across the active space. See relationship graph.
• Tools (action palette → Tools): Format JSON, Diff Checker, Base64 encoder/decoder. See Developer tools.
• Keyboard-first throughout: Cmd+J on macOS (Ctrl+J elsewhere) enters navigation mode; Cmd+K / Cmd+P open the action and project palettes. See the keyboard reference.

CLI

The CLI works without a running desktop. Records use DEVCROFT_DATA_DIR or the normal per-OS root.

devcroft repository list --json
devcroft artifact create --repository KEY --title "Implementation plan" --kind plan --content-file plan.md --json
devcroft review list --open

Agent skill

In Settings → Agent → Devcroft skill, install the bundled CLI skill for Claude Code and/or Codex/shared agents (OpenCode discovers these locations too). The same installer works headless:

devcroft skill install
devcroft skill status

Modified or unmanaged skill folders are preserved. The maintained bundle lives in assets/skills/devcroft/ and is embedded in the binary, so installation needs neither network access nor a source checkout.

Development

mise run fmt
mise run check
mise run test

Ordinary builds use GPUI Fast. The default feature switches Kit and the macOS WebView wrapper together so they share GPUI types.

GPUI Kit and gpui-webview use 0.8.0. Composed tutorial pages stay visible behind palettes, menus, dialogs, and navigation hints on GPUI Fast. GPUI Pre and hosts where native composition fails keep the hide-while-overlay fallback. Sheets hide the tutorial on both backends because Kit does not compose them above native content yet.

cargo run --locked -- app
cargo test --locked

To use GPUI Pre, disable the application's default features:

cargo run --locked --no-default-features -- app
cargo test --locked --no-default-features

To compare CPU rendering work, run the ignored reader/review benchmarks with each backend, using the same toolchain and an idle machine. Repeat each command several times; fixture construction and warmup are excluded from the reported median and p95 milliseconds per input/render cycle.

# GPUI Pre
cargo test --locked --no-default-features backend_benchmark_ -- --ignored --nocapture --test-threads=1
# GPUI Fast
cargo test --locked backend_benchmark_ -- --ignored --nocapture --test-threads=1

These use GPUI's test platform. They do not measure native GPU presentation, display pacing, terminal output, or embedded WebView behavior. Native performance and interaction need separate verification.

Docs

• Home dashboard
• Editor setup and everyday use
• Language support
• Terminal
• Repository resources
• Relationship graph
• Review comments
• Developer tools
• Keyboard reference

Contributing

GitHub Issues are disabled — please use GitHub Discussions for bug reports, feature requests, questions, ideas, and support. PRs are welcome, including AI-assisted ones: they must meet the same quality bar as any other contribution (run mise run check, describe what changed and how you verified it), and the author is responsible for everything in the PR. For security reports, see Security Policy instead of opening a discussion.

License

MIT — see LICENSE. Third-party font and icon attributions live in assets/ (notably assets/icons/ATTRIBUTION.md).