Workspace

Workspace/ is Flint's active work surface for repositories that belong inside the current workspace.

If Sources/ is where you bring in reference material, Workspace/Repos/ is where you put repositories that you expect to actively edit, run, inspect, and commit against as part of the Flint's day-to-day work.

Workspace Repositories

Manage them with the workspace command group:

flint workspace create "App" git@github.com:me/app.git
flint workspace list
flint workspace update "App"
flint workspace remove "App"

The current implementation stores them in:

Workspace/Repos/

and declares them in flint.toml:

[workspace]
repositories = [
  { name = "App", url = "git@github.com:me/app.git" },
]

What These Commands Actually Do

• create creates a repository folder under Workspace/Repos/, runs git init, and can attach a remote
• update pulls the latest changes if the repo exists, or clones it if the local folder is missing
• remove deletes the repository folder and removes the declaration from config
• list shows which repositories are declared and whether each one is present locally

This is the part of Flint where code-facing shard workflows often meet the actual codebase being worked on.

Why Workspace Repositories Matter for Agents

A Flint is not just a note collection. It is an environment where an agent can execute cognitive programs and then act on real code or other active assets.

Workspace/Repos/ is how that environment exposes editable repositories to the agent without mixing them into the Mesh. The Mesh holds the reasoning. The workspace repo holds the implementation surface.

Workspace/Bench

The standard Flint bootstrap also creates Workspace/Bench/.

The current public CLI does not expose a richer user-facing command model around Bench, but the directory remains part of the standard workspace layout and can be used as an auxiliary scratch or testing surface when a workspace needs one.

Workspace vs Sources

The distinction is simple but important:

• Workspace/Repos/ is for active repositories you work in
• Sources/Repos/ is for copied reference repositories you read from

If a repository is part of the current Flint's active execution environment, it belongs in Workspace/Repos/.