@kodwai/cli

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

What is kodwai?

kodwai is a dual platform where developers solve AI-agent coding challenges and compete on leaderboards, and companies run AI-native technical interviews with full session capture and scoring.

For Developers

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 or Cursor)
3. Create a workspace with the problem statement and starter files
4. Start the timer

Work with your AI agent, 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)

Commands

kodwai challenge <id-or-slug>    Start a coding challenge
kodwai submit                    Submit your solution
kodwai start <session-id>       Start an interview session (company invitations)

Options:
  --api-url <url>                Override API URL
  --token <session-token>        Session token (interviews only)

For Companies

When a company invites you to an interview, run the command from the invitation email:

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

This launches Claude Code with a proxied API key, full session tracing, and real-time streaming to the interviewer's dashboard.

Requirements

• Node.js 20+
• Git (auto-installed if missing)

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