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 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- 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 docs live under docs/development.
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.