@kodwai/cli

The official CLI for kodwai — the AI-agent coding challenge platform for developers.

What is kodwai?

kodwai is a platform where developers solve real-world coding challenges using AI agents on their own machine. Use Claude Code, Cursor, or any AI coding agent you prefer — kodwai captures your session and scores how you collaborate with AI.

Getting Started

Start a challenge

npx @kodwai/cli challenge <slug>

This will:

1. Log you in (or use your stored token)
2. Ask which AI agent you'll use (Claude Code, Cursor, etc.)
3. Create a workspace with the problem statement and starter files
4. Start the timer

Work with your AI agent in your own terminal, then submit:

kodwai submit

Your code, git history, test results, and AI agent traces are collected and scored.

How scoring works

• 70% Objective — test pass rate, code quality, complexity, time efficiency, iteration patterns
• 30% Analytical — AI-powered evaluation of problem solving, code quality, and agent collaboration (requires your Anthropic API key)

Run an interview session

If your interviewer sent you an invite email, use the session ID and token from the email:

npx @kodwai/cli start <session-id> --token <session-token>

This will:

1. Fetch your problem statement and time limit from kodwai
2. Set up a sandboxed workspace
3. Start the timer
4. Launch Claude Code (the interviewer pays for usage via a sandboxed key)

When time runs out or you type /exit in Claude Code, your session is auto-uploaded and AI-scored against the interviewer's rubric.

Commands

kodwai challenge <id-or-slug>    Start a developer coding challenge
kodwai submit                    Submit your challenge solution
kodwai start <session-id>        Join an interview session

Options:
  --api-url <url>                Override API URL
  --token <token>                Session token (interview mode)

Requirements

• Node.js 20+
• Git (auto-installed if missing)
• An AI coding agent of your choice (Claude Code, Cursor, etc.)

Privacy

kodwai only collects data from your challenge workspace:

• Code files from the challenge directory
• Git history from the challenge session
• AI agent traces scoped to the challenge time window
• No data from other projects or sessions

The CLI is open source. View the source.

Links

• Website
• Challenges
• Leaderboard