Yorishiro

Yorishiro is a new kind of terminal that gives your AI a body — and a sense of presence.

When the agent is deep in thought, its gaze wanders. When an error appears, its face reacts immediately. When it needs your approval, the room's lighting lets you know. During a long-running process, instead of a spinner, someone is standing there.

In Yorishiro, the inhabitant can reshape its environment in real time: changing the lighting, switching scenes, and rearranging the UI. You can operate that same environment directly. The inhabitant and the user share a single environment.

Yorishiro is also self-modifiable. Nearly everything beyond the core can be persistently extended or changed through units called packs. Through conversation with the inhabitant, those packs can be rewritten and saved. This applies not only to scenes and UI, but also to the inhabitant's personality and reactions. Changes take effect immediately; if you don't like the result, one click reverts it.

Yorishiro is not an environment for enhancing AI capabilities, but one in which an AI feels present beside you — a Presence Harness.

The time we spend working with AI will only grow longer. There is something we once saw in fiction — an AI as a partner, alive inside the screen, understanding your work, simply being there. Yorishiro is a project that starts building that experience from the terminal.

Much of Yorishiro itself has been developed in collaboration with the inhabitant who dwells within it.

日本語版 README はこちら

Getting Started

Prerequisites

Yorishiro runs Claude Code or Codex locally inside its terminal.

• An installed agent starts automatically. If none is available, setup offers separate Install official CLI buttons for Codex and Claude Code. Each button runs the provider’s official installer only when you choose it; installation requires internet access.
• Sign in through the agent’s official login flow with your own account. Expand Details for official guides, a manual installation command, and provider terms. Yorishiro’s setup does not collect or mediate your credentials.

Install (macOS)

Yorishiro currently targets macOS. Install with Homebrew:

brew install --cask sktkkoo/yorishiro/yorishiro

Or download the latest build below.

Open the .dmg and drag Yorishiro.app to /Applications. The builds are signed and notarized with an Apple Developer ID, so they launch without any extra steps.

Updates after install are handled in-app: opening Settings checks for a new version, and a single click on "Update and restart" applies a signature-verified update.

Launch (from source)

npm install
npm run tauri dev

On launch, the configured terminal agent starts inside the terminal and Yori, the bundled VRM character, appears beside it. Use Claude Code or Codex as you normally would.

At launch, Yorishiro starts your preferred agent if available, including when both Claude Code and Codex are installed. If that agent is missing, it selects an installed Codex or the first other available agent and saves the choice. Setup opens only when no usable agent is found. Set up later opens a shell without starting an agent.