# 2026-05-22-repo-clone-mode-with-ssh
dir: 2026-05-22-repo-clone-mode-with-ssh

index: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md

## role
Implements a repository clone mode with SSH key support to enable isolated, clean-room git operations inside tool instances without affecting host working copies.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document specifying a system to support both mount and clone repository access modes for tool instances, with SSH key management for clone operations. | dep: GitRepository, ToolInstance, Alembic, compose templates, SSH key system, _modify_compose_file
- proposal.md | Proposes a feature to add repository clone mode with SSH key support for isolated tool instances, enabling clean-room development and git operations inside containers without affecting the host working copy. | dep: GitRepository, ToolInstance, Docker, SSH keys, database migrations, backend API, frontend UI
- tasks.md | A completed task checklist for implementing SSH key-based git clone functionality with mount/clone modes across database, backend, frontend, and DevOps infrastructure | dep: Alembic, Pydantic, SQLAlchemy, FastAPI, React/TypeScript, pytest, ruff, mypy, npm, git, subprocess, SSH
## arch
Feature-driven documentation-first architecture using OpenSpec schema configuration, design/proposal/task documents, and cross-stack implementation (database, backend, frontend, DevOps) supporting dual access modes (mount vs. clone) with SSH credential management.
## tags
clone, ssh, design, key, git, .openspec, support, mount
## symbols
-
## workflows
-
## dirty
-