← Basecode

Documentation

Make Basecode your workspace.

Get set up, choose your coding models, and bring supported configuration from other agents into Basecode.

Get started

  1. Get Basecode from the download section and open the desktop app.
  2. Sign in with your Cencori account. When the browser prompts you to return to Basecode, continue into the app.
  3. Choose a project folder, or start a new task by describing what you want to build.
  4. Choose a model in the composer, send your request, and follow the task’s progress. Review file changes in the review panel and respond to any approval requests.

You can start without importing another agent’s setup. Imports are an optional way to carry familiar instructions and configuration into your workspace.

Agents & imports

Open Settings → Agents & imports to find supported setups on this device and choose what to bring over. The page separates detection, importing, and connecting because they do different things.

  • Detected on this device: Basecode found configuration it can import. Detection alone does not copy anything or connect an account.
  • Other agents: supported import sources with no setup found, alongside agents whose integrations are not available yet.
  • Import: copies selected supported items into Basecode. It does not transfer a subscription or use another agent to execute tasks.
  • Connect: is reserved for running tasks through an external agent. These connections are not implemented in the current app, so Connect buttons are disabled.

Current support

Available agent integrations in Basecode
AgentImport setupRun through subscription
Claude CodeSupported when detectedNot available yet
CursorSupported when detectedNot available yet
CodexNot available yetNot available yet
OpenCodeNot available yetNot available yet
GitHub CopilotNot available yetNot available yet
OrcaNot available yetNot available yet

An existing subscription is not an API key. There is currently no subscription connection to configure on this page; importing a setup does not enable one.

Import a setup

  1. Set up Claude Code or Cursor on the same computer. Add the project folder to Basecode if you want it included when looking for project-specific configuration.
  2. Open Settings → Agents & imports. Basecode checks supported sources on the first visit and remembers the result. Use Check again after changing your setup or adding a project.
  3. Choose Import on a detected agent’s card. The dialog shows the items actually found, with descriptions and counts where available.
  4. Select the items you want, then confirm with Import to Basecode. Configuration items start selected; past conversations start unselected.
  5. Check Import history for the outcome. If a part fails, review Needs attention and retry that item.

What can come across?

Depending on the source and what is detected, the dialog can include instructions, settings, skills, plugins, MCP server configuration, subagents, hooks, commands, memory, and past conversations. Not every source supplies every kind; the dialog is the authoritative list for your device.

Past conversations copy what was said into Basecode and require an explicit selection. Importing configuration does not guarantee that an external service is ready to use: a service may still need its own credentials or setup.

Keep imports in sync

The Import syncing section sits below the agent cards. After a successful import, enable Keep imports in sync to refresh previously imported configuration when you visit this settings page.

  • Only kinds of configuration already imported successfully are eligible, and they must still be detected.
  • Sync does not automatically opt you into new categories of data.
  • Past conversations are excluded from automatic syncing, even if you imported them manually.
  • This is a device preference. It is not continuous background monitoring or cloud synchronization.

Use Check again to refresh detection. Turning syncing off stops future automatic imports; it does not undo earlier imports. Turning it back on allows another sync during the current visit.

Choose models and providers

Open Settings → Models to browse Cencori’s coding model catalog. Maximo Atlas and GLM are enabled by default. Toggle additional available models on to show them in the composer, then select one there for your task.

Enabled models appear below the defaults in settings, followed by curated coding recommendations. Search filters the list; the refresh icon reloads the catalog. Choices are saved for your account on this device. Auto remains a fallback when no model is enabled.

Model availability depends on your plan. A disabled model with a frontier-plan note requires a plan that permits it. A Free badge identifies an offered free model; open weights alone do not imply free hosted usage.

Settings → Providers is the separate place for supported API-key connections. Adding an API key is different from importing agent configuration or connecting a coding subscription.

Troubleshooting

My agent is installed but not detected

Detection looks for importable configuration, not simply an installed application. Confirm that you have used and configured a supported source on this computer, include the relevant project in Basecode, and select Check again. Codex, OpenCode, Copilot, and Orca do not currently have import adapters.

The Import button is disabled

Wait for detection or the current import to finish. If no supported items are found, there is nothing to import. For unsupported agents, the disabled button indicates that the integration is not available yet.

Part of an import failed

Read the item’s error under Needs attention. Resolve the reported issue, such as an unavailable source, and use Retry for that item. Import history shows successful and failed outcomes separately.

Sync did not copy a new conversation

This is expected. Open Import again and explicitly select Past conversations. Automatic syncing only refreshes previously imported, eligible configuration.

A model is missing or the catalog is unavailable

Use the refresh button in Settings → Models and check your connection. The default models remain listed if the catalog cannot be loaded. Check both the model toggle and your plan if a catalog entry is not available in the composer.