bots-garden/sidekickspublic Fork
⑂ v1.1.0
Commits
⬇ Clone ▾
git clone https://git.rickub.com/bots-garden/sidekicks.git
git clone ssh://git@rickub.com/bots-garden/sidekicks.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Download ZIP
📦️ Create a release. 0a53b99 · on v1.1.0 · k33g · 2d ago
repartir-de-zero.md · 57 lines · 3.8 KBmarkdown
Blame HistoryOpen raw

Repartir de zéro

Ce guide montre comment revenir à un état propre : la configuration, l'historique des conversations, ou les deux, depuis l'application (la Danger zone de Settings) ou à la main.

Ce que Sidekicks garde, et où

Tout est dans un seul dossier : ~/Library/Application Support/sidekicks/ sous macOS, ~/.config/sidekicks/ sous Linux (ou $XDG_CONFIG_HOME/sidekicks/).

Fichier ou dossier Contient
config.yaml la configuration par défaut : agents, channels à créer, préférences
preferences.json la dernière configuration ouverte depuis l'application, et les récentes
data/ l'historique : une base par fichier de configuration (channels, membres, messages, commandes des agents)

Depuis l'application : la Danger zone

  1. Ouvrez Settings et dépliez Danger zone, en bas du panneau.

  2. Choisissez ce qui doit repartir de zéro :

    Choix Effet Copie gardée
    Reset the settings Le fichier de configuration en cours revient à celui par défaut ; preferences.json (dernier fichier ouvert, récents) est oublié. config.<date>.yaml à côté du fichier, preferences.<date>.json
    Clear the history of this configuration Les channels, membres et messages de cette configuration. Les channels qu'elle déclare sont recréés. data/<empreinte>.<date>/
    Clear the history of every configuration L'historique de tous les fichiers de configuration. data.<date>/
    Reset everything Les settings et l'historique de toutes les configurations. les trois
  3. Cliquez sur Reset…, lisez ce qui sera perdu, puis Reset. Les agents démarrés sont arrêtés si l'historique est touché. Les modifications non enregistrées de l'éditeur sont perdues si les settings le sont.

  4. La liste des copies gardées s'affiche. Sidekicks reste utilisable, sans redémarrage.

La date a la forme 2026-10-31T08-15-00 (sans :). Les copies ne sont jamais rouvertes par Sidekicks : supprimez-les quand vous n'en avez plus besoin (voir Variantes).

À la main

Quittez d'abord Sidekicks (⌘Q) : il garde l'historique ouvert tant qu'il tourne. Sous macOS (sous Linux, remplacez le dossier comme ci-dessus) :

cd ~/Library/Application\ Support/sidekicks
rm -rf data                 # toutes les conversations et tous les channels, de toutes les configurations
rm -f preferences.json      # le dernier fichier ouvert et les récents : la configuration par défaut se rouvre
rm -f config.yaml           # la configuration : une configuration commentée par défaut est écrite au prochain lancement

Ne lancez que les lignes utiles. Relancez ensuite Sidekicks.

Variantes

  • Supprimer les copies de la Danger zone : dans le dossier ci-dessus, rm -rf data.20* data/*.20* preferences.20*.json, et les config.<date>.yaml à côté de votre fichier de configuration.
  • Récupérer une copie : quittez Sidekicks, puis renommez-la à son nom d'origine (par exemple mv data.2026-10-31T08-15-00 data, après avoir écarté le data actuel).
  • L'historique d'une seule configuration : chaque dossier de data/ appartient à un fichier de configuration, mais son nom est une empreinte du chemin du fichier. Faute de pouvoir le reconnaître, réinitialisez tout data/.
  • Retrouver les agents de test après avoir supprimé config.yaml : make install-test-config à la racine du dépôt.
  • Garder une copie : renommez au lieu de supprimer, par exemple mv data data.old.
  • Taille des panneaux : elle est gardée par la fenêtre elle-même ; Settings et le journal démarrent de toute façon repliés à chaque lancement.

Voir aussi

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Repartir de zéro

Ce guide montre comment revenir à un état propre : la configuration, l'historique des conversations, ou les deux, depuis l'application (la **Danger zone** de Settings) ou à la main.

## Ce que Sidekicks garde, et où

Tout est dans un seul dossier : `~/Library/Application Support/sidekicks/` sous macOS, `~/.config/sidekicks/` sous Linux (ou `$XDG_CONFIG_HOME/sidekicks/`).

| Fichier ou dossier | Contient |
| --- | --- |
| `config.yaml` | la configuration par défaut : agents, channels à créer, préférences |
| `preferences.json` | la dernière configuration ouverte depuis l'application, et les récentes |
| `data/` | l'historique : une base par fichier de configuration (channels, membres, messages, commandes des agents) |

## Depuis l'application : la Danger zone

1. Ouvrez **Settings** et dépliez **Danger zone**, en bas du panneau.
2. Choisissez ce qui doit repartir de zéro :

   | Choix | Effet | Copie gardée |
   | --- | --- | --- |
   | **Reset the settings** | Le fichier de configuration en cours revient à celui par défaut ; `preferences.json` (dernier fichier ouvert, récents) est oublié. | `config.<date>.yaml` à côté du fichier, `preferences.<date>.json` |
   | **Clear the history of this configuration** | Les channels, membres et messages de cette configuration. Les channels qu'elle déclare sont recréés. | `data/<empreinte>.<date>/` |
   | **Clear the history of every configuration** | L'historique de tous les fichiers de configuration. | `data.<date>/` |
   | **Reset everything** | Les settings et l'historique de toutes les configurations. | les trois |

3. Cliquez sur **Reset…**, lisez ce qui sera perdu, puis **Reset**. Les agents démarrés sont arrêtés si l'historique est touché. Les modifications non enregistrées de l'éditeur sont perdues si les settings le sont.
4. La liste des copies gardées s'affiche. Sidekicks reste utilisable, sans redémarrage.

La date a la forme `2026-10-31T08-15-00` (sans `:`). Les copies ne sont jamais rouvertes par Sidekicks : supprimez-les quand vous n'en avez plus besoin (voir Variantes).

## À la main

Quittez d'abord Sidekicks (⌘Q) : il garde l'historique ouvert tant qu'il tourne. Sous macOS (sous Linux, remplacez le dossier comme ci-dessus) :

```bash
cd ~/Library/Application\ Support/sidekicks
rm -rf data                 # toutes les conversations et tous les channels, de toutes les configurations
rm -f preferences.json      # le dernier fichier ouvert et les récents : la configuration par défaut se rouvre
rm -f config.yaml           # la configuration : une configuration commentée par défaut est écrite au prochain lancement
```

Ne lancez que les lignes utiles. Relancez ensuite Sidekicks.

## Variantes

- **Supprimer les copies de la Danger zone** : dans le dossier ci-dessus, `rm -rf data.20* data/*.20* preferences.20*.json`, et les `config.<date>.yaml` à côté de votre fichier de configuration.
- **Récupérer une copie** : quittez Sidekicks, puis renommez-la à son nom d'origine (par exemple `mv data.2026-10-31T08-15-00 data`, après avoir écarté le `data` actuel).
- **L'historique d'une seule configuration** : chaque dossier de `data/` appartient à un fichier de configuration, mais son nom est une empreinte du chemin du fichier. Faute de pouvoir le reconnaître, réinitialisez tout `data/`.
- **Retrouver les agents de test** après avoir supprimé `config.yaml` : `make install-test-config` à la racine du dépôt.
- **Garder une copie** : renommez au lieu de supprimer, par exemple `mv data data.old`.
- **Taille des panneaux** : elle est gardée par la fenêtre elle-même ; Settings et le journal démarrent de toute façon repliés à chaque lancement.

## Voir aussi

- [Modifier ou changer la configuration](modifier-ou-changer-la-configuration.md)
- [Référence : historique](../reference/agents-et-evenements.md#historique)