Projekte und Startvorlagen

Jedes Repository, an dem du arbeitest, ist ein Projekt: ein Ordner unter /work/<project> auf deiner Konto-Disk. Ein Klick startet Claude Code, Codex oder OpenCode darin, jeden auf seinem eigenen Abo, mehrere nebeneinander.

Projekte auf shipyard: api, storefront, etl-pipeline und landing, jedes mit den Agenten, die darauf laufen.

Was ein Projekt ist

Ein Projekt ist ein Ordner unter /work/<project> auf deiner Konto-Disk, neben deinem Home-Ordner /home/dev. Er enthält deinen Code, seine Startvorlagen und die Agent-Sitzungen, die sie alle teilen, und er bleibt, wenn die Terminals enden, die ihn benutzt haben.

Ein Projekt-Terminal sieht sein Projekt und deinen gemeinsamen Home-Ordner. Jedes Terminal hat eigenes Docker und eigene Systempakete. Ein Shell-Terminal sieht alle deine Projekte.

/work/<project> · CLAUDE.md · AGENTS.md · .claude/ · .mcp.json

Ein Projekt anlegen

Öffne Projekte und wähl Neues Projekt.
Wähl, woher der Code kommt:
- Klonen: Füg die Adresse ein, die du git clone gibst, etwa git@github.com:you/app.git oder https://…. Geklont wird mit deinen git-Schlüsseln auf deinem Compute, also funktionieren private Repositorys.
- Leer: ein leerer Ordner. Lass Als git-Repository anlegen angehakt, um mit git init zu starten.
- Ordner: ein Ordner in /home/dev auf deinem Compute. Er wird ins Projekt kopiert und bleibt, wo er war.
Prüf das Feld Name. Er folgt dem Repository oder dem Ordner, bis du einen eigenen tippst: bis zu 40 lateinische Kleinbuchstaben, Ziffern und Bindestriche. Der Name wird zum Pfad, /work/<name>.
Wähl Projekt anlegen.

Ein großes Repository zu klonen dauert ein paar Minuten, und die Seite folgt von selbst. Dein erstes Projekt kann auch direkt nach dem Checkout unter Terminals starten: Loslegen zeigt die drei Fragen.

Einen Agenten im Projekt starten

Eine Startvorlage ist ein Agent und das, womit er läuft: Claude Code, Codex oder OpenCode, auf einem Abo oder einem API-Key. Dazu kommt ein Modell, wenn du ein anderes als den Standard des Agenten willst, und für Claude Code und Codex Rotation und Nach dem Limit-Reset weitermachen.

Wähl zuerst den Agenten, dann unter Läuft mit ein Konto, das er nutzen kann: ein Claude-Abo für Claude Code, ein ChatGPT-Abo für Codex oder einen passenden API-Key für jeden der drei. Agenten listet, welcher Key mit welchem Agenten funktioniert.

Die erste Startvorlage in einem Projekt wird seine Standard-Startvorlage: die, die ein einziger Klick ausführt. Jede andere Kombination, die du startest oder speicherst, wartet unter Gespeicherte Startvorlagen. Dort startest, bearbeitest oder entfernst du sie oder machst sie zum Standard.

Jede Startvorlage hält ihre eigenen Einstellungen und ihre Anmeldung im Projekt, außerhalb von git. Die Sitzungen des Agenten gehören dem Projekt: Jede seiner Startvorlagen sieht sie in claude --resume oder codex resume, und eine neue Startvorlage macht in der neuesten weiter, egal mit welchem Konto sie begonnen wurde.

Claude / Codex · API · Rotation

Ein neues Terminal öffnen

Wähl Neues Terminal in Terminals und füll drei Felder aus: Projekt, Agent und Läuft mit. Wähl Starten. Eine Kombination, die du schon gespeichert hast, läuft so, wie sie ist; eine neue wird unterwegs als Startvorlage im Projekt gespeichert, bereit fürs nächste Mal.

Neues Projekt… in der Projektliste holt weiteren Code dazu, und Shell öffnet eine einfache Login-Shell, die keine Startvorlage braucht. Jede Wahl startet eine frische Umgebung, also wähl ein laufendes Terminal in der Liste, um dorthin zurückzukehren.

Neues Terminal auf shipyard: Projekt, Agent und womit er läuft wählen, dann Starten; oder eine normale Shell öffnen.

Jedes Terminal in der Liste zeigt sein Projekt, seinen Agenten und das Konto, mit dem er läuft, mit einem Rotationszeichen, wenn seine Startvorlage Abos durchwechselt.

Das Projekt api: Claude Code mit Rotation als Standard-Startvorlage, einen Klick entfernt, und Codex review auf eigenem Konto unter den gespeicherten Startvorlagen.

Was für den nächsten Lauf bleibt

Dein Projektordner mit seinem Code, seinen Startvorlagen und jeder Agent-Sitzung darin bleibt auf der Konto-Disk, und genauso alles in /home/dev.

Docker-Images, Build-Cache, Container, apt-Pakete und Systemdienste gehören zu diesem Terminal. Nach dem Schließen des Browsers laufen sie weiter; beim Beenden des Terminals werden sie entfernt. Speichere Datenbanken und Arbeit im Projekt oder Home.

Eine Startvorlage entfernen oder ein Projekt löschen

Startvorlage entfernen: Öffne ihr Menü ⋯ auf der Projektseite und wähl Entfernen. Ihre Tabs schließen sich, und ihre Einstellungen und ihre Anmeldung verlassen das Projekt. Code und Sitzungen des Agenten bleiben für die anderen Startvorlagen des Projekts.
Projekt löschen: Öffne das Menü ⋯ des Projekts, wähl Projekt löschen und tipp seinen Namen ein. Seine Tabs schließen sich, seine Startvorlagen gehen, und der Ordner wird mit allen Dateien und Agent-Sitzungen gelöscht. Pushe vorher, was du behalten willst.

Projekte und Service-Keys

Mit Vault bekommt jedes Projekt seinen eigenen Sallyport-Agenten namens detachbox · <project>, für dich angelegt und geteilt von allem, was im Projekt läuft. Was jedes Projekt aufrufen darf, legst du in Sallyport fest, und sein Pass liegt im Ordner .detachbox des Projekts.