Interactive Mode

Learn how to use the interactive, conversational AI mode in Kodezi CLI for real-time development assistance.

Kodezi CLI’s Interactive Mode allows you to work with AI in a natural, conversational way. You can execute development tasks, review code, debug problems, and generate new functionality simply by typing instructions in plain English.

It behaves like an intelligent coding partner, directly inside your terminal.

Key Capabilities

1. Natural Language Interface

You can talk to Kodezi CLI just like you would talk to a teammate. Simply type what you want, and the AI understands.

Examples:

“Fix the error in auth.ts.”
“Refactor this function to make it easier to read.”

No commands or technical syntax needed, plain English works.

2. Context Continuity

Kodezi remembers what you were working on. If you mention a file, issue, or code snippet once, you don’t need to repeat it again.

This means you can continue a task naturally:

  • “Now fix the second function too.”
  • “Add tests for that feature.”

Kodezi keeps track of your ongoing workflow.

3. Real time Streaming Responses

You don’t have to wait for the entire answer to load. Kodezi streams output live in the terminal, so you see the response as it’s being generated, similar to watching code or logs appear instantly.

4. Multi turn Conversations

You can complete complex tasks step-by-step in a single session. Kodezi supports ongoing back-and-forth interactions like:

  • Generating a new feature
  • Editing or improving it
  • Debugging issues
  • Optimizing code after fixes

It behaves like a continuous conversation instead of separate isolated commands.

5. Persistent Sessions

Kodezi automatically saves your conversations using SQLite. This means:

  • Nothing is lost when you close the CLI
  • You can reopen old sessions
  • You can continue exactly where you left off

This is helpful for long term projects, debugging sessions, or multi day development work.

Starting Interactive Mode

You can start Kodezi CLI in different ways depending on how you want to work.

Start normal interactive mode

kodezi

This command starts Kodezi in the folder you are currently in. It opens a new interactive session where you can chat with the AI, edit files, run commands, and get help instantly.

Start Kodezi in a specific directory

kodezi -c /path/to/project

Use this when you want to work in a different project folder without navigating to it manually. Kodezi will open the session directly inside the directory you specify.

Enable debug mode

kodezi -d

This starts Kodezi with extra debugging information. Use it when you want to troubleshoot issues because it shows detailed logs about what the CLI is doing in the background.

Additional Features Inside Interactive Mode

1. Automatic Session Titles

Kodezi automatically creates a title for your session based on your first message, making it easier to find later.

2. Session Summarization

Long conversations are summarized intelligently.
This reduces token usage while keeping the important context intact.

3. Token & Cost Tracking

Every session keeps track of:

  • Input tokens
  • Output tokens
  • Cost per message
  • Cache reads and writes

This helps you understand your usage and manage costs better.

4. Prompt Queue Management

If you send several prompts quickly, Kodezi processes them one by one in the correct order, no commands are lost.

5. Cancel Any Operation

You can instantly stop AI generation or any ongoing task by pressing:

Ctrl + C