secret-setup

Configure secret storage for an Instar agent across Bitwarden, local encrypted storage, or manual handling.

75|18|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/JKHeadley/instar --skill secret-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: secret-setup
Source: https://github.com/JKHeadley/instar/tree/main/.claude/skills/secret-setup
Command: npx skills add https://github.com/JKHeadley/instar --skill secret-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users choose and configure a safe place for Instar secrets such as API tokens, bot credentials, and session keys, so setup does not stall on manual credential handling.

Core Features & Use Cases

  • Backend Selection: Guides the user through Bitwarden, a local encrypted store, or manual secret entry.
  • Credential Handling: Collects only the needed login details, unlocks or logs into Bitwarden, and avoids interactive CLI hangs.
  • State Persistence: Saves the chosen backend and Bitwarden session state so the main Instar setup can continue smoothly.
  • Use Case: A user wants to install Instar on a new machine and restore agent secrets securely without retyping everything later.

Quick Start

Use the secret-setup skill to help me choose and configure the best secret storage option for my Instar agent.

Frequently Asked Questions about secret-setup

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

FAQPage Schema
How do I configure secret storage for API tokens when setting up an agent?

Configuring secret storage for API tokens involves choosing between Bitwarden, local encrypted storage, or manual entry. The setup verifies CLI availability, manages the login flow, and persists the session state without exposing your credentials.

What is the best way to manage Bitwarden session state for an Instar agent?

Managing Bitwarden session state is done by logging in through a setup workflow that persists the session. This allows the main Instar setup to continue smoothly and avoids interactive CLI hangs during future agent operations.

Does Bitwarden secret management work without causing interactive CLI hangs?

Bitwarden secret management works without interactive CLI hangs by collecting only the needed login details and managing the unlock flow programmatically. This prevents the terminal from stalling during the agent onboarding process.

Can I use local encrypted storage instead of Bitwarden for bot credentials?

You can use local encrypted storage instead of Bitwarden for bot credentials. The setup workflow guides you through backend selection, allowing you to choose local storage and record the selected backend for the Instar agent configuration.

How do I securely restore agent secrets on a new machine without retyping credentials?

Securely restoring agent secrets on a new machine without retyping is achieved by configuring a centralized backend like Bitwarden during the initial setup. The persisted session state allows the agent to retrieve API tokens and bot credentials automatically.