Vik

Vik is a local Rust service for unattended coding-agent orchestration. It reads issues from commands, matches each returned state to stages in workflow.yml, creates one issue workspace, and runs one-shot agent CLI processes for stage work.

Vik does not own tracker state. Prompt files must say which commands read and update issues, comments, pull requests, and links.

Install

Install the latest release binary:

curl -fsSL https://github.com/yii-labs/vik/releases/latest/download/install.sh | sh -

The installer supports Linux x64, Linux arm64, and macOS arm64. It installs to ~/.local/bin by default. Override that with VIK_INSTALL_DIR:

curl -fsSL https://github.com/yii-labs/vik/releases/latest/download/install.sh | VIK_INSTALL_DIR=/usr/local/bin sh -

You can also install from crates.io:

cargo install vik --locked

Usage

• Start with Get Started.
• Run as a detached local process through Service Daemon.
• Tune workflow settings through Configuration.
• Configure tracker commands through Linear, GitHub, or Feishu Base.
• Inspect logs, daemon state, and session JSONL through Observation.

Development

Development docs live under docs/development.

Credits

Vik is adapted from OpenAI's Symphony workflow and harness patterns. Vik is also inspired by Sandcastle for prompt file design and commands output injection.