Apiboo-Dokumentation

DokuErste Schritte

Projekte: ein Umschalter für alles

Wähl oben in der Titelleiste ein Projekt, und API Requests, Boards, Dokumente, Verbindungen und der Graph zeigen dieses Projekt.

Ein Projekt bündelt den API-Arbeitsbereich, die Boards, Dokumente und Verbindungen, die zusammengehören. Du wählst es einmal in der Titelleiste, und jedes Werkzeug, das mit deinem Projekt arbeitet, zeigt dieses Projekt, ohne eigenen Umschalter pro Werkzeug.

Der Projekt-Umschalter

Der Projekt-Umschalter offen über Boards: All projects, No project, das persönliche Projekt Shop mit Häkchen, New project… und Manage projects…

Der Umschalter sitzt links in der Titelleiste. Er zeigt:

EintragWas du siehst
All projectsAlles, wie vor den Projekten
No projectNur, was noch in keinem Projekt ist, damit du es einsortieren kannst
PersonalDeine eigenen Projekte
Eine Gruppe pro TeamDie Projekte dieses Teams
New project… / Manage projects…Eines anlegen oder die Projekte-Seite öffnen

Tipp, um zu suchen, und wähl mit ↑ ↓ und Enter. Apiboo merkt sich das Projekt pro Gerät und öffnet es beim nächsten Start wieder.

Der Umschalter erscheint bei API Requests, History, Boards, Documents, FTP, DB Manager, Terminal, Graph und Projects. Kalender, Chat, Vault und Einstellungen gehören zu keinem Projekt; dort ist er ausgeblendet.

Was dem Projekt folgt

WerkzeugUnter einem Projekt
API RequestsÖffnet den API-Arbeitsbereich des Projekts. Wählst du im Arbeitsbereich-Umschalter einen Arbeitsbereich, wechselt auch das Projekt mit.
BoardsNur die Boards des Projekts. Die Personal-/Team-Chips sind ausgeblendet.
DocumentsMain und die Dokumentationsbereiche des Projekts, siehe Dokumentationsbereiche
FTP / SFTP und TerminalZuerst die Verbindungen des Projekts unter seinem Namen, dann Other connections (einklappbar). Nichts wird ausgeblendet.
DB ManagerDie Verbindungen des Projekts stehen im Baum oben.
GraphDas Projekt und was es enthält. Sein eigenes Show project ändert dasselbe Projekt wie die Titelleiste.
KI-AssistentKennt das aktive Projekt; Boards, Dokumente und Ordner, die er anlegt, landen darin.

Unter No project zeigt jedes Werkzeug, was in keinem Projekt ist. Unter All projects wird nichts gefiltert.

Laufende Terminal-Sitzungen und offene Datenbank-Tabs bleiben beim Wechsel offen; nur die Listen ändern sich.

Dinge in ein Projekt legen

  • Alles, was du anlegst, während ein Projekt gewählt ist (ein Board, ein Dokument oder Ordner auf oberster Ebene, eine SSH- oder Datenbank-Verbindung), landet in diesem Projekt.
  • Aus einer Liste: Das ⋯-Menü eines Boards und das Rechtsklick-Menü eines Dokuments haben Add to project ›, und unter einem Projekt Remove from das Projekt. Unter einem Projekt hat das Zeilenmenü einer FTP-/SFTP- oder Terminal-Verbindung Add to das Projekt oder Remove from das Projekt.
  • Auf der Projektseite: Öffne Projects, dann das Projekt, und such. Add from your workspace zeigt, was du hinzufügen kannst; Add all fügt alle gelisteten Einträge auf einmal hinzu.

Ein Eintrag kann in mehreren Projekten sein. Nimmst du ihn aus einem Projekt oder löschst du das Projekt, wird der Eintrag nie gelöscht: Er landet wieder unter No project.

Ein Team-Projekt enthält nur Einträge dieses Teams, und alle im Team sehen es.

Der API-Arbeitsbereich des Projekts

Die Seite eines Projekts: das Projekt Shop mit dem Dropdown API workspace auf Shop, dem Suchfeld und seinem einen Board

Auf der Projektseite wählt API workspace den Arbeitsbereich, den API Requests für das Projekt öffnet, oder None. Ein Team-Projekt kann nur einen Arbeitsbereich nutzen, der mit diesem Team geteilt ist. Betrachter im Team sehen ihn, können ihn aber nicht ändern.

Dokumentationsbereiche

Der Documents-Umschalter unter dem Projekt Biz: Main mit Häkchen, der Bereich Guides, New space… und Manage spaces…

Unter einem Projekt listet der Documents-Umschalter nicht mehr Personal oder deine Teams, sondern Main und die eigenen Dokumentationsbereiche des Projekts. So hält ein Projekt API-Doku, Runbooks und Notizen getrennt.

  • Main enthält die Seiten des Projekts, die in keinem anderen Bereich sind.
  • New space… legt einen Bereich mit Name, Symbol und Farbe an und öffnet ihn.
  • Manage spaces… benennt um, färbt um, sortiert (ziehen) und löscht. Ein gelöschter Bereich löscht nie eine Seite: Seine Seiten landen wieder in Main.
  • Eine Seite ist immer in genau einem Bereich. Verschieb sie mit Move to space › im Rechtsklick-Menü oder zieh sie im Umschalter auf einen Bereich. Eine Seite in einem Ordner wandert mit ihrem Ordner.
  • Eine neue Seite oder ein neuer Ordner auf oberster Ebene landet im offenen Bereich.

Apiboo merkt sich den offenen Bereich pro Projekt auf diesem Gerät. Unter All projects ist die Documents-Seitenleiste wie bisher.

Git-Arbeitsbereiche

Ein Git-Arbeitsbereich schreibt sein Projekt in die apiboo.yaml des Repositorys (seine ID, seinen Namen und seine Farbe, sonst nichts). Klonst du oder ein Teammitglied das Repository, landet der neue Arbeitsbereich in diesem Projekt, oder in einem neuen persönlichen Projekt mit demselben Namen und derselben Farbe, wenn du es nicht hast. Ein Gerät, auf dem der Arbeitsbereich in keinem Projekt ist, lässt die Datei, wie sie ist; so überschreiben sich Geräte nicht gegenseitig.

KI-Agenten (MCP)

Ein über MCP verbundener Agent sieht über graph_project, welche Einträge in einem Projekt sind; dafür braucht er die Leseberechtigung Graph (siehe Der Graph für KI-Agenten). Die Board- und Dokument-Werkzeuge kennen keinen Projektfilter, also erfährt ein Agent ohne Graph-Berechtigung nichts über deine Projekte.