Getting started

Cone is a native macOS desktop app for running coding agents in project-scoped threads. It drives the agent CLIs you already have installed, so there is no separate account or API key to configure.

Requirements

macOS 14 or newer.
At least one signed-in agent CLI on your PATH: claude (Claude Code), or codex 0.146 or newer.

Cone resolves CLIs through a login shell, so installs from Homebrew, npm, or a version manager are found even though GUI apps do not inherit your terminal’s PATH.

Install

Download Cone-v<version>.zip from the latest release.
Unzip it and move Cone.app to Applications.
Launch it and pick a project folder to start your first thread.

Cone checks for updates at launch. Minor and patch releases download automatically and install when you restart. Major releases show the release notes and ask first. See Updates and releases for channels and details.

Your first thread

Every thread lives in a folder you choose, usually a git repository. Pick the folder, choose a provider and model in the composer, and type. The turn streams into the transcript with reasoning, shell commands, file changes, and token usage as they happen.

From there:

Mention files with @, attach images, and use the CLI’s slash commands from the composer.
Open the right rail for the file tree, git changes, and a persistent terminal.
Create more threads in other folders. Cone groups them by repository in the sidebar.

Run from source

git clone https://github.com/vaporwavie/cone
cd cone
swift run                  # build and launch the development app
./scripts/bundle.sh        # build a double-clickable Cone.app

SwiftPM resolves dependencies on the first build. Development runs show a DEV badge and report version dev.