> ## 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.

# Finkkle One Studio: AI Development in Your Environment

> Finkkle One Studio puts Dufus in your IDE, CLI, browser, and GitHub — so you can write, review, and ship code with AI assistance wherever you work.

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

Finkkle One Studio is the AI development environment that puts Dufus — the Finkkle coding agent — directly inside the tools you already use. Work side-by-side with Dufus locally, hand off to the cloud when you step away, and review every change before it ships.

## Where Studio runs

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal">
    Install the CLI and run `studio` in any project directory. Dufus has full access to your local file system within the project.
  </Card>

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

  <Card title="Web Studio" icon="globe">
    Access Studio at [one.finkkle.com](https://one.finkkle.com) without any local setup. Connect to a GitHub repo or work in the cloud sandbox.
  </Card>

  <Card title="GitHub" icon="github">
    Connect a repository to Studio. Dufus can read the full tree, draft commits, create issues, and review pull requests.
  </Card>
</CardGroup>

## Install the CLI

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

After installation, run `studio` from any project directory:

```bash theme={null}
cd my-project
studio
```

The CLI opens a Dufus session with your current directory as context. The prompt shows your model, directory, and remaining context:

```text theme={null}
>_ Finkkle Studio (v0.93.0)
model: arctic-1.3  /model to change
directory: ~/my-project
Tip: Use /fork to branch current chat

100% context left  finkkleone://cli
```

## CLI commands

| Command         | Description                                       |
| --------------- | ------------------------------------------------- |
| `studio`        | Start a Dufus session in the current directory    |
| `/model <name>` | Switch the active model (e.g., `/model gpt-5.4`)  |
| `/fork`         | Branch the current conversation into a new thread |
| `/clear`        | Start a fresh session                             |
| `/help`         | List all available commands                       |

The context meter shows how much of the model's context window is remaining. When it fills, use `/fork` to continue in a branched thread without losing your work.

## Example workflow

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

# Start a session in your project
cd my-api
studio

# Ask Dufus to implement a feature
> Hey Studio, add exponential backoff to the notifications API

# Dufus responds, edits files, and shows a diff
# Review, approve, and continue
```

## Connecting GitHub

To connect a repository:

1. Open Studio at [one.finkkle.com](https://one.finkkle.com)
2. Click **Connect to GitHub**
3. Select the repository you want to work with
4. Dufus gains read access to the file tree and can create branches, issues, and commits within approved scope

<Warning>
  Grant only the permissions Studio needs for the task at hand. For read-only code review and explanation, grant read access only. Only grant write access when you intend to commit changes.
</Warning>

## Model selection in Studio

Switch models at any point with the `/model` command or the model selector in the web UI:

| Model            | Best for                                  |
| ---------------- | ----------------------------------------- |
| **Arctic 1**     | Fast completions, short tasks             |
| **Arctic 1.3**   | Longer context, complex reasoning         |
| **GPT-5.4**      | Agents and professional-grade work        |
| **GPT-5.5**      | Highest intelligence for complex projects |
| **GPT-5.4-mini** | Fast pipelines, lightweight tasks         |

<Tip>
  Start with Arctic 1.3 for most development tasks — it has strong reasoning and a large context window. Switch to GPT-5.4 or GPT-5.5 when you need higher capability for multi-step planning or large refactors.
</Tip>