WebCull
cli

Authentification

Authorize multiple CLI accounts, select one by hash, verify its identity, and safely log out.

Autoriser La CLI Avec Un Flux D Approbation Navigateur

La CLI utilise un flux d'approbation de courte durée dans le navigateur. N'approuvez que les demandes que vous avez lancées avec webcull login; l'approbation crée un jeton CLI distinct et limité.

Separate access

L'autorisation de la CLI est distincte de la connexion dans le navigateur et l'extension. Le token de chaque compte est stocké dans une entrée distincte des identifiants du système d'exploitation, tandis que le fichier de configuration ne conserve que les détails non secrets du compte.

Demarrer La Connexion Et Verifier Le Compte

webcull login
webcull accounts
webcull whoami --account <account-hash>
webcull login
Lance l'autorisation et ouvre la page d'approbation dans le navigateur.
webcull auth login
Alias de webcull login.
webcull accounts
Affiche chaque compte autorisé localement avec son identifiant utilisateur, son hash, son expiration et son état actif, sans imprimer les tokens.
webcull whoami --account <account-hash>
Affiche le compte autorisé et l'expiration du jeton.

Garder plusieurs comptes connectés en même temps

Chaque connexion réussie ajoute une autre autorisation locale de la CLI. Utilisez --account <hash|id> pour sélectionner un compte pour une commande. Sans cette option, les commandes ordinaires utilisent le dernier compte consulté avec succès.

webcull accounts
webcull bookmarks count --account abc123 --path /
webcull bookmarks search --account abc123 --query 'project notes' --limit 20
{
  "success": "true",
  "active_account": "abc123",
  "accounts": [
    {
      "number": 1,
      "active": true,
      "user": {
        "id": 42,
        "hash": "abc123",
        "name": "Personal",
        "email": "[email protected]"
      }
    }
  ]
}
Agent selection

Les agents doivent exécuter webcull accounts au début d'un nouveau contexte WebCull. Avec un seul compte, ils utilisent automatiquement son hash. Avec plusieurs comptes, ils affichent une liste numérotée, demandent lequel s'applique et incluent ce hash dans chaque commande suivante.

Choisir le compte avant de révoquer l'accès

webcull logout
webcull logout --account abc123
webcull logout --account abc123 --local-only

Lorsque plusieurs comptes sont connectés, la commande interactive webcull logout affiche un sélecteur numéroté. Les clients non interactifs reçoivent une réponse de sélection de compte et doivent relancer la commande avec le hash ou l'identifiant utilisateur prévu.

La déconnexion normale révoque le token de serveur sélectionné avant de supprimer son identifiant local. La déconnexion locale uniquement supprime l'identifiant local sélectionné et avertit que son token de serveur peut rester valide.

Lire La Reponse Du Compte

{
  "success": "true",
  "user": {
    "id": 42,
    "hash": "abc123abc123abc123abc123abc123",
    "email": "[email protected]"
  },
  "scopes": ["bookmarks:read", "bookmarks:write"],
  "expires": 1781300000
}

Utilisez scopes pour vérifier les capacités de ce jeton. Les commandes de lecture exigent bookmarks:read. La création, la mise à jour, la création de rappels et leur annulation exigent bookmarks:write.

Étape suivante cli Lectures De Favoris Utilisez les commandes count, tree et get pour examiner l'emplacement des favoris et récupérer des enregistrements précis.