> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finkkle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dufus: AI Coding Agent in Finkkle Spaces and Studio

> Dufus is the AI coding agent in Finkkle Spaces. It writes, explains, refactors, and debugs code for local repos and cloud workspaces.

<Warning>
  **Dufus is temporarily unavailable.** Finkkle One is undergoing a major overhaul, and all Finkkle One services, including Dufus and Studio, are down or disabled until further notice. Finkkle Trends remains accessible. More details soon.
</Warning>

Dufus is the AI coding agent at the heart of Finkkle Spaces and Finkkle One Studio. Whether you're writing a feature from scratch, debugging a tricky issue, explaining an unfamiliar codebase, or refactoring a module, Dufus works alongside you in your IDE, the CLI, or directly inside a Spaces conversation.

## What Dufus can do

<CardGroup cols={2}>
  <Card title="Write code" icon="pen-to-square">
    Implement features, components, functions, and full modules from a plain-language description. Dufus includes ARIA labels, tests, and edge cases when asked.
  </Card>

  <Card title="Explain code" icon="book-open">
    Paste any code snippet and ask Dufus to explain the logic, identify patterns, or walk through it step by step.
  </Card>

  <Card title="Debug and fix" icon="bug">
    Share an error message or failing test. Dufus diagnoses the issue, suggests a fix, and explains why it went wrong.
  </Card>

  <Card title="Refactor" icon="arrows-rotate">
    Ask Dufus to improve structure, reduce duplication, apply a design pattern, or modernize syntax — with a diff for review.
  </Card>

  <Card title="Work with repos" icon="code-branch">
    Connect a GitHub repository and Dufus can navigate the file tree, understand project structure, draft issues, and review pull requests.
  </Card>

  <Card title="Add tests" icon="flask">
    Dufus writes unit and integration tests for existing code. Specify the framework (Jest, pytest, Vitest, etc.) and it handles the rest.
  </Card>
</CardGroup>

## Use Dufus in Finkkle Spaces

Switch any Spaces conversation to **Code** mode to use Dufus:

1. Start a conversation at [spaces.finkkle.com](https://spaces.finkkle.com)
2. Select **Code** as the conversation mode
3. Describe your coding task or paste code into the composer
4. Attach files, a GitHub repo, or a local directory as context

Dufus outputs syntax-highlighted code artifacts that you can copy, save to your workspace, or continue iterating on in the same conversation.

**Example prompts:**

```text theme={null}
"Implement a sliding window rate limiter in TypeScript. Include unit tests with Vitest."
"Explain what this React component does and identify any accessibility issues."
"Refactor this Python function to use asyncio and add error handling."
"Review my PR and flag any potential performance issues."
```

## Use Dufus via Finkkle One Studio

Finkkle One Studio puts Dufus directly in your development environment:

<CardGroup cols={2}>
  <Card title="Install the CLI" icon="terminal">
    ```bash theme={null}
    npm i -g @finkkleone/studio
    ```

    Run `studio` from any project directory to start a Dufus session in your terminal.
  </Card>

  <Card title="IDE Extension" icon="window-restore">
    Install the Finkkle Studio extension for your IDE. Dufus appears as a side panel — chat with it while you edit files, with full project context.
  </Card>

  <Card title="Web Studio" icon="globe">
    Access Studio at one.finkkle.com. Work on cloud projects or connect to a GitHub repo without a local setup.
  </Card>

  <Card title="GitHub Integration" icon="github">
    Connect your repository to Studio. Dufus can read the full file tree, create branches, and draft commits.
  </Card>
</CardGroup>

## Studio CLI commands

Once the CLI is installed:

```bash theme={null}
npm i -g @finkkleone/studio
```

| Command  | What it does                                        |
| -------- | --------------------------------------------------- |
| `studio` | Opens a Dufus session in the current directory      |
| `/model` | Switch the active model (e.g., `/model gpt-5.4`)    |
| `/fork`  | Branches the current conversation into a new thread |
| `/help`  | Lists all available commands                        |

The CLI shows your **context window usage** in real time — when context fills up, use `/fork` to branch or `/clear` to start fresh.

## Supported languages

Dufus works across all major languages. It is especially well-tested with:

* JavaScript / TypeScript
* Python
* Go
* Rust
* C / C++
* Java
* SQL
* Bash / Shell

## Best practices

<Tip>
  * Give Dufus the specific file or function you want to work on — it performs better with focused context than with an entire large codebase.
  * Always review generated code before committing. Dufus will tell you what it changed and why.
  * Use `/fork` in the CLI when you want to explore a different approach without losing your current conversation.
  * Attach tests when asking Dufus to refactor — it will try to keep the tests passing.
</Tip>