Documentation

Get started with QikDeck

QikDeck is a desktop workspace for building software with AI. This guide covers the core concepts to help you plan, build, and review work across your projects.

Version 1.0Last updated Sep 2026

Overview

QikDeck brings capable coding agents together with project-aware conversations, real terminals, remote development, and a visual view of the work happening across your projects. It's built for developers, technical founders, and independent builders who want a graphical way to work with AI across real projects.

From a quick bug fix to a multi-step feature, QikDeck helps you move from an idea to changes you can inspect.

Installation

Download the QikDeck desktop app for your operating system and install it. On first launch, sign in and connect your preferred models. Your projects and conversations stay organized in one consistent interface.

Account credentials use the operating system's secure credential storage. Saved application data can be exported without including account credentials or project files.

Your first workspace

Organize your work into named workspace boards, each with up to eight project, Chat, or terminal panes. Use Command Center to see several panes together, and switch to Focus when one task deserves your full attention.

Your workspace remembers its layout, pane order, and selected view. Keep a frontend project, backend service, research conversation, and terminal together,or create separate workspaces for different products and clients.

Coding agents

Describe what you want to accomplish. QikDeck's agents can explore your codebase, develop a plan, edit files, run commands, execute tests, and explain the results. Follow their progress through a structured activity timeline, respond when they need your input, and inspect the changes they make.

The work happens against your actual project,not just inside a conversation. Agents can read project files, search for relevant code, make targeted edits, run commands, and check their work with available tests.

Blueprint planning

Start with a read-only plan before making changes. Review the proposed approach, ask for revisions, and choose when to implement it.

RolePurpose
ArchitectReasons through the approach during planning.
EngineerCarries out the implementation.

The Architect/Engineer workflow lets you assign models to planning and implementation separately, with an optional Architect review after implementation. Use one model to reason through the approach and another to carry it out.

Models & providers

QikDeck supports several ways to connect:

  • Your own provider accounts and API keys.
  • Compatible local and self-hosted model servers.
  • Supported ChatGPT account connections.

Provider profiles include QikLM, Qwen, DeepSeek, MiniMax, Gemini, Z.ai, Kimi, and custom OpenAI- or Anthropic-compatible endpoints. Choose a model for the conversation and adjust supported thinking or effort controls without learning a different application for every provider.

View context usage and, when supplied by the provider, real token-generation speed. QikDeck also shows task duration, helping you distinguish how long the overall work took from how quickly the model generated tokens.

Terminals & SSH

Open a local terminal alongside your agents and conversations. Run Git, development servers, build tools, SSH, or your preferred command-line applications. QikDeck's terminal panes are ordinary system terminals,not simulated AI command windows,so your existing tools remain part of your workflow.

Connect project agents to local folders or remote Linux development machines. With Remote SSH, the agent's file operations and commands run on the selected remote host, beside the project. You keep the same graphical workflow while working with code on a server.

Permissions & control

QikDeck provides four permission modes:

ModeDescription
Ask FirstApproval-led execution.
Workspace AutoRoutine project work with safeguards for sensitive actions.
Plan ModeRead-only investigation and planning.
Full AccessExplicitly broader execution permissions.

Structured file-edit tools make changes visible through live editing activity, changed-file summaries, and reviewable diffs. When a command changes files without an exact recorded patch, QikDeck distinguishes those observations from changes with a known diff. You get a clearer account of the work,not invented certainty.

Handle approvals and agent questions directly in the app. Stop a task when needed.

Subagents

Built-in subagents let an agent delegate supporting work, such as examining different parts of a codebase or investigating a focused question. Follow their activity in the same visual workflow, with configurable concurrency limits to control how much delegated work runs at once.

Goals

Goals provide a persistent objective for multi-step work, with controls for managing progress and optional token budgets. For longer conversations, context compaction helps continue the work without carrying every earlier message forward verbatim.

Project indexing

Background project indexing provides a lightweight map of filenames, declarations, and imports for supported languages. The agent can search by filename, symbol, or text and inspect the current source before editing. Index controls let you enable, disable, rebuild, or clear the project's navigation cache. It helps the agent locate relevant code without requiring a whole-repository upload.

MCP connections

Extend QikDeck with compatible Model Context Protocol servers. Connect additional tools and data sources, manage their configuration and authentication, and choose the execution targets where they are available. Your agents can work with more of your development environment through the same conversation interface.

Optional local memory can retain useful conventions, preferences, and project information across conversations. Choose automatic assistance, manage memory manually, or turn it off. Global and workspace scopes help keep general preferences separate from project-specific context. Local memory is currently experimental.

Bring your next project to the deck.

Plan it. Build it. Review it. Keep the work in view.