claude-cluster docs1.10.1
Advanced conceptsConcepts avancés

Categories, tags and the taxonomyCatégories, tags et taxonomie

Label sessions, nest the labels in a tree, and read it as a list, a grouped list and the hub graph.Étiqueter les sessions, imbriquer les étiquettes dans un arbre, et le lire en liste, liste groupée et graphe hub.

1. Categories and tagsCatégories et tags

Each session has one category (a word: bugfix, docs...) and any number of tags. They are set by the global session (session_describe: category, tags, add_tags, remove_tags) or by you: /category <word>, /tags a b (or +a -b), the palette Category / Tags, claude-cluster label <s> --category c --tag a,b, a click on them in the web page. No model is called. They are kept with the session (trash, restore, /clear) and shown as coloured chips under the description.

session_list filters by category, tag (several: all required), state (open, archived = the trash, all, or a state) and under (a node of the taxonomy). search and claude-cluster search find #tag (labels only) or text in a label; the palette opens a session by its labels.

Chaque session a une catégorie (un mot : bugfix, docs...) et un nombre quelconque de tags. Ils sont posés par la session globale (session_describe : category, tags, add_tags, remove_tags) ou par vous : /category <mot>, /tags a b (ou +a -b), la palette Category / Tags, claude-cluster label <s> --category c --tag a,b, un clic dessus dans la page web. Aucun modèle n'est appelé. Ils suivent la session (corbeille, restauration, /clear) et s'affichent en pastilles colorées sous la description.

session_list filtre par category, tag (plusieurs : tous requis), state (open, archived = la corbeille, all, ou un état) et under (un nœud de la taxonomie). search et claude-cluster search trouvent #tag (étiquettes seulement) ou un texte dans une étiquette ; la palette ouvre une session par ses étiquettes.

2. The taxonomyLa taxonomie

Categories and tags form a forest: each node has an optional parent (another category or tag); none means it hangs under the root global. It is stored in taxonomy.json of the data folder and sent to every interface. A session hangs under its primary label (its category, else its first tag, else global).

  • session_list filters category / tag also match the sessions under the labels below them (descendants: false: the label itself only); under takes any node.
  • Edit it with the graph (Set parent, Rename, Merge into, Delete, Add node), the palette (Taxonomy: ...), claude-cluster taxonomy [set_parent <node> [parent] | rename <node> <new> | merge <node> <into> | delete <node> [strip]], or the MCP tool taxonomy (list, set_parent, rename, merge, delete). A cycle is refused and deleting a node moves its children to its parent. The tool is refused while [agent] taxonomy_edit is off.

Catégories et tags forment une forêt : chaque nœud a un parent optionnel (une autre catégorie ou un tag) ; aucun signifie qu'il pend sous la racine global. Elle est stockée dans taxonomy.json du dossier de données et envoyée à toutes les interfaces. Une session pend sous son étiquette principale (sa catégorie, sinon son premier tag, sinon global).

  • Les filtres category / tag de session_list trouvent aussi les sessions sous les étiquettes situées en dessous (descendants: false : l'étiquette seule) ; under prend n'importe quel nœud.
  • Modifiez-la avec le graphe (Set parent, Rename, Merge into, Delete, Add node), la palette (Taxonomy: ...), claude-cluster taxonomy [set_parent <nœud> [parent] | rename <nœud> <nouveau> | merge <nœud> <dans> | delete <nœud> [strip]], ou l'outil MCP taxonomy (list, set_parent, rename, merge, delete). Un cycle est refusé et supprimer un nœud déplace ses enfants vers son parent. L'outil est refusé tant que [agent] taxonomy_edit est désactivé.

3. Grouped listListe groupée

[ui] group_by_category (settings, the palette Group by category, /group, a button in the web page) groups the session list by category, nested by the taxonomy: one head per level of the path of the node, in the terminal, the window, the web page and the app.

[ui] group_by_category (réglages, la palette Group by category, /group, un bouton de la page web) groupe la liste des sessions par catégorie, imbriquée par la taxonomie : un en-tête par niveau du chemin du nœud, dans le terminal, la fenêtre, la page web et l'application.

4. Graph viewsVues graphe

The Hub (web page, window, app: right click or the bar) and the graph of the terminal (Alt+G) show the cluster as a graph.

  • Hub as a tree: global at the root, category and tag nodes coloured like their chips with the number of sessions below, sessions as leaves coloured by state (green working, orange waiting for a permission, red error, grey idle). Nodes fold. Focus shows only a node's descendants, By every tag puts a session under each of its labels, archived sessions are greyed, a click on a node filters the session list to what is below it. Labels never overlap: they are placed around their node, the status dropped first, then the title shortened, then a dot. The ring view stays one click away.
  • Terminal graph (Alt+G, read only): the global session in the middle, sessions around it, a solid link for working and dashed for idle. Pan with the arrows or Z Q S D, zoom with the wheel or E / A, 0 fits, F centres the selection, Tab selects, Enter or a double click opens the session, L the legend, M a minimap, Esc leaves. Far away (zoom under 0.8) names are shortened, under 0.45 nodes are dots. The keys are graph_* in keys.

A graph of your code (files, classes, calls) is a different thing: that is the html-doc skill of the repository, not claude-cluster.

Le Hub (page web, fenêtre, application : clic droit ou la barre) et le graphe du terminal (Alt+G) montrent le cluster sous forme de graphe.

  • Hub en arbre : global à la racine, nœuds de catégories et de tags colorés comme leurs pastilles avec le nombre de sessions en dessous, sessions en feuilles colorées selon l'état (vert au travail, orange en attente de permission, rouge en erreur, gris au repos). Les nœuds se replient. Focus ne montre que les descendants d'un nœud, By every tag met une session sous chacune de ses étiquettes, les sessions archivées sont grisées, un clic sur un nœud filtre la liste de sessions sur ce qui est en dessous. Les libellés ne se chevauchent jamais : placés autour de leur nœud, l'état supprimé d'abord, puis le titre raccourci, puis un point. La vue en anneau reste à un clic.
  • Graphe du terminal (Alt+G, lecture seule) : la session globale au milieu, les sessions autour, un lien plein pour « au travail » et en pointillé pour « au repos ». Déplacement avec les flèches ou Z Q S D, zoom avec la molette ou E / A, 0 cadre tout, F centre la sélection, Tab sélectionne, Entrée ou un double clic ouvre la session, L la légende, M une mini-carte, Échap quitte. De loin (zoom sous 0,8) les noms sont raccourcis, sous 0,45 les nœuds sont des points. Les touches sont les graph_* de la référence des touches.

Un graphe de votre code (fichiers, classes, appels) est autre chose : c'est le skill html-doc du dépôt, pas claude-cluster.