Cheshi

# Cheshi

A desktop workspace for AI-assisted development. Work with Codex, explore your
codebase with CodeGraph, and manage code, terminals, and Git in one place.

[Releases](https://github.com/CheshiAI/Cheshi/releases) ·
[Changelog](CHANGELOG.md) ·
[English help](.docs/help/en/) · [한국어 도움말](.docs/help/ko/) ·
[CodeGraph guide](.docs/codegraph/guide.md)

[Report an issue](https://github.com/CheshiAI/Cheshi/issues/new/choose) ·
[Contribute](CONTRIBUTING.md)

Cheshi is in preview. Install it through the
[Cheshi Homebrew Tap](https://github.com/CheshiAI/homebrew-tap), or download the
signed and notarized ZIP from [Releases](https://github.com/CheshiAI/Cheshi/releases).

## Install with Homebrew

The first packaged release requires **Apple Silicon and macOS Tahoe 26 or later**
because its bundled CodeGraph executables require macOS 26. Install
[Homebrew](https://brew.sh/) if it is not already available, then run:

```sh
brew install --cask cheshiai/tap/cheshi
```

This installs Cheshi into Applications. The Cask declares **GitHub CLI
(`gh`)** and **Codex CLI (`codex`)** as dependencies, so Homebrew installs them
when they are not already registered with Homebrew. If you installed either CLI
through another package manager, check for an existing installation conflict.

### First launch

1. Open **Cheshi** from Applications.
2. Follow the Codex sign-in prompt if needed. Installation does not sign you in.
3. In **Workspaces**, open a local folder, create a project, or clone a repository.
   Sign in to GitHub when prompted for GitHub features.
4. Cheshi creates the workspace's initial CodeGraph index automatically. Once
   indexing completes, explore the code graph or ask Codex about the project.

**CodeGraph is included and configured by Cheshi.** You do not need a separate
Co