Develop locally and run commands seamlessly on UNSW CSE servers.

Documentation · Getting started · Releases

biwa keeps your preferred editor and tooling on your own machine, synchronizes your project efficiently, and runs CSE-specific commands remotely. It is a modern, actively maintained successor to cserun.

• Edit locally while running autotest, give, and other commands on CSE.
• Synchronize only changed files with smart remote path handling.
• Forward environment variables and standard input when needed.
• Clean up stale remote projects to stay within CSE disk quotas.

Using mise (recommended):

mise use -g github:risu729/biwa

Alternatively, install from crates.io:

cargo install biwa

Windows users should run biwa inside WSL2.

Initialize a project, configure your CSE account in the generated biwa.toml, then run a command:

biwa init
biwa run 1511 autotest lab01

See the getting started guide for SSH setup and configuration, or browse the full CLI reference.

This repository uses mise for tool versions, tasks, and project dependency setup.

mise install
mise deps

Common workflows:

mise run build
mise run test
mise run check --lint

See the contributing guide for the full development workflow.