For AI agents: the complete documentation index is available at https://docs.flezise.com/llms.txt, the full documentation bundle is available at https://docs.flezise.com/llms-full.txt, and this page is available as Markdown at https://docs.flezise.com/projects/import-codebase.md.
Docs

Import a codebase

Flezise can work from a repository you already have. Choosing Existing codebase in the onboarding wizard creates a work item on the board so the agent can plan an analysis pass. A separate repository scan reads the codebase and raises tech-debt findings as additional work items.

Choose Existing codebase

In the /onboarding wizard, select Existing codebase when the first question asks what you are starting from. The wizard asks what existing inputs to treat as source material: the repo URL, any documents, or both.

Describe the system and paste the repository URL. After you submit, the wizard creates a work item on the board of type brownfield and takes you directly to that item so you can see the plan the agent proposes.

Repository scan

Once a repository URL is associated with the project, you can run a scan from Settings → General. In the Repositories section, confirm or enter the repo URL and press the Scan repository button.

The scan runs a system-reconnaissance pass through the code. Before the crawl starts, the consent and approval steps are recorded server-side:

  1. The scan is proposed with the target URL.
  2. A coordinator approves the proposed scan.
  3. If the repository requires authentication, credentials are stored in an encrypted, session-scoped vault.
  4. The crawl is dispatched.

The scan is always read-only. It does not modify the repository.

Triage findings

After the scan completes, each finding in the inventory is presented for triage. For each finding you decide whether to raise it as a work item or dismiss it. A note is optional but useful for explaining why an item was dismissed or flagging context for the agent.

Accepted findings appear on the board as work items. The agent proposes a plan for each one before executing, so you review and approve before any code changes are made.

Note

The Existing codebase, Enhancement, Migration, and Redesign starting modes each create a work item on the board rather than going through the standard intake interview. The product brief for these projects is drafted from the codebase analysis and your description, not from the interview batches.

FAQ

Can I run the scan more than once?

Yes. Press Scan repository again from Settings → General at any time. Each scan proposes a fresh crawl and goes through the same consent-and-approval step.

Does the scan store my source code?

The scan indexes structure and metadata for analysis. Code content read during the crawl is processed in the agent's throwaway sandbox and does not persist beyond the scan run.