skills.rest
beclab
beclabOFFICIAL
Explore all skills by this author →
GitHub

olares-shared

Manage olares-cli profiles and token life-cycle across OS keychains.

5.2k|320|Updated Apr 29, 2024
Search Tags:#security#authentication#profile#token-management#refresh-token#two-factor-auth#olares-cli
One-click install
npx skills add https://github.com/beclab/Olares --skill olares-shared
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: olares-shared
Source: https://github.com/beclab/Olares/tree/main/cli/skills/olares-shared
Command: npx skills add https://github.com/beclab/Olares --skill olares-shared

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and standardizes the olares-cli authentication lifecycle by providing a reusable profile model, first-time login with password + TOTP, bootstrap from an existing refresh token, and robust handling for profile switching, listing, and removal across OS keychains and token stores.

Core Features & Use Cases

  • Profile lifecycle: login (password + optional 2FA), import from a refresh token, list profiles with status, switch current profile, and remove profiles.
  • Global profile flag: use --profile to script actions against multiple profiles without changing the current one.
  • Token storage and refresh: describes where tokens live per OS and automatic token refresh via /api/refresh with reactive retry and proactive refresh for streaming uploads.
  • Recovery and troubleshooting: guidance for common auth errors (expired/invalid tokens, not logged in, 2FA required) and how to recover by re-authenticating or importing.
  • Use cases: suitable whenever configuring olares-cli for the first time, scripting parallel invocations, or managing multiple identities.

Quick Start

Run olares-cli profile login --olares-id <id> to create or authenticate your first profile.

Frequently Asked Questions about olares-shared

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage multiple olares-cli profiles for different identities?▼

You can manage multiple olares-cli profiles by using the profile lifecycle commands to list, switch, and remove identities. A global --profile flag enables scripting actions against multiple profiles without changing the current one.

How does token storage and automatic refresh work for olares-cli authentication?▼

Token storage securely saves credentials in OS keychains, while automatic token refresh uses the /api/refresh endpoint. This includes reactive retries and proactive refreshes during streaming uploads to maintain seamless authentication.

Can I bootstrap an olares-cli profile from an existing refresh token?▼

Yes, you can import a profile from an existing refresh token. This allows you to bootstrap authentication without a full login, enabling quick setup for scripting or multi-profile workflows.

Why does my olares-cli login fail with a two-factor authentication requirement?▼

Two-factor authentication is required for secure first-time login. You must provide a TOTP code alongside your password; if authentication fails, re-authenticating or importing a token resolves common expired or invalid token errors.

What is the best way to script parallel olares-cli invocations across multiple profiles?▼

Use the global --profile flag to script parallel actions against multiple identities without altering the current profile. This enables cross-process deduplication and robust handling for parallel workflows.

Related Skills

Explore More Software Engineering Skills→
nansen-ainansen-ai
127

nansen-wallet-migration

Migrate Nansen CLI wallet passwords from insecure files to OS keychain.

Official
Intermediate
yamcodesyamcodes
138

gh-cli

Automate GitHub workflows and repository tasks using the gh CLI.

Community
Intermediate
EmeaAppGbbEmeaAppGbb

microsoft-agent-framework

Build and orchestrate AI agents with Microsoft Agent Framework.

Official
Intermediate
MovchanetsMovchanets

auth-implementation-patterns

Design secure authentication and authorization systems for APIs and microservices.

Community
Advanced