Getting started

k4tron is a coding agent that works with you wherever you work — it reads, edits and runs code in your project. There are two clients, and both are the same k4tron: the VS Code extension and the CLI for any terminal. Your account and your sessions work in both. This guide takes you from install to first task.

1. Install a client

  • Extension: add k4tron to your VS Code.
  • CLI: install k4tron from npm and run k4tron in your project’s terminal — works with any editor, on Windows, macOS and Linux.

There’s no API key to configure and no settings panel: the clients are deliberately simple.

2. Generate your connection code

The first time you open a client, it asks to connect — click “Generate connection code” (in the extension) or follow the link the CLI shows. It opens app.k4tron.com/connect with your device name pre-filled — create your account there. Every new account is born with trial credits, no card.

3. Paste the code

The site generates a code shaped like k4t_…. Copy it, go back to the client, paste it into the “Paste the code (k4t_…)” field and connect. Each device uses its own code, revocable anytime from your account.

4. Open a session

Once connected, the session panel appears. Open a new session to begin. Every conversation is a session you can resume whenever you want — including from the other client: start in the editor, pick up in the terminal.

5. Send your first task

Type what you want (“fix the failing tests”, “refactor this module”, “start a dev server”) and hit Enter. The agent plans, reads context and executes in your project — you watch every step in the feed.

  • Permissions: by default the agent asks for confirmation before each action (“Ask permission” mode). For full autonomy, switch to “Auto-approve”.
  • Tiers: pick the tier for the task — Lite (trivial), Basic (general use, the default), Standard (daily development) and Premium (architecture and large refactors). You pick the tier; the platform handles the model.
  • Credits: the session cost shows up in credits, in real time, in the status bar.

These docs are a work in progress — more sections are coming soon.