mirror of
https://github.com/agentrhq/authsome.git
synced 2026-09-19 01:34:19 +08:00
Manoj Bajaj
61515356a2
Align public docs with Principal/Vault/Identity terminology, current daemon API paths, and the CLI/proxy/export integration surface instead of the removed AuthService library API. Co-authored-by: Cursor <cursoragent@cursor.com>
104 lines
4.6 KiB
Plaintext
104 lines
4.6 KiB
Plaintext
---
|
|
title: "Changelog"
|
|
sidebarTitle: "Changelog"
|
|
description: "Curated release history. For the full per-commit log, see CHANGELOG.md in the repository."
|
|
icon: "clock-rotate-left"
|
|
keywords: ["authsome changelog", "authsome release notes", "authsome version history"]
|
|
---
|
|
|
|
A curated summary of authsome releases. For the full per-commit log, see [CHANGELOG.md](https://github.com/agentrhq/authsome/blob/main/CHANGELOG.md) in the repository.
|
|
|
|
<Update label="0.7" description="2026-06-16">
|
|
**Documentation refresh.** Public Mintlify docs updated for the Principal / Vault / Identity model. Retired profile-based terminology, removed references to the old in-process `AuthService` library API, and aligned installation, doctor, and daemon API pages with the current storage layout.
|
|
|
|
**Current integration surface.** CLI commands, `authsome run` proxy injection, `authsome export`, and the daemon HTTP API (with PoP JWT auth) are the supported paths for agents and tooling.
|
|
</Update>
|
|
|
|
<Update label="0.6.x" description="2026-06-06 to 2026-06-09">
|
|
**Next.js dashboard.** Static dashboard served from the daemon root with provider and connection management UI.
|
|
|
|
**Self-hosting.** Docker Compose setup and self-hosting guide for running the daemon outside a laptop.
|
|
|
|
**Provider expansion.** Bundled providers for Google Workspace services, Jira, Confluence, YouTube, Vertex AI, Todoist, Cloudflare, Outlook, Word, Calendar, Zoom, Reddit, and more.
|
|
|
|
**Architecture cleanup.** Multi-server-compatible identities, cleaner UI auth flows, and client/server home directory split (`~/.authsome/client/` vs `~/.authsome/server/`).
|
|
</Update>
|
|
|
|
<Update label="0.5.0" description="2026-05-29">
|
|
⚠ **Breaking:** Principal claim flow required for vault access. Existing local installs must register a Principal and accept the identity claim.
|
|
|
|
⚠ **Breaking:** Vault encryption moved to Argon2id KEK/DEK model. Fernet-encrypted vaults cannot be read back; re-login required.
|
|
|
|
**Audit events and principal roles.** Structured audit logging with admin/user roles. Admin audit dashboard.
|
|
|
|
**Browser SSO.** Chrome cookie reading for providers that support it.
|
|
|
|
**Anthropic and Gemini** bundled providers added.
|
|
</Update>
|
|
|
|
<Update label="0.4.0" description="2026-05-25">
|
|
⚠ **Breaking:** Principal, Vault, and Identity replace the old profile model. Credentials are namespaced under `vault:<vault_id>:...`. See [Principal, Vault, and Identity](/concepts/principal-vault-identity).
|
|
|
|
**Claim flow.** Identities must claim a Principal before accessing credentials.
|
|
|
|
**Master key rotation.** `rekey` command and API endpoint.
|
|
|
|
**CLI restructure.** Provider and admin command namespaces.
|
|
</Update>
|
|
|
|
<Update label="0.3.x" description="2026-05-20">
|
|
**Configurable proxy scope.** `connected_allow` and related proxy modes in client config.
|
|
|
|
**Health checks.** Readiness validates connections for the active identity.
|
|
|
|
**Telemetry.** Opt-out PostHog analytics via environment variables.
|
|
</Update>
|
|
|
|
<Update label="0.2.x" description="2026-04-28 to 2026-05-08">
|
|
**Browser bridge for sensitive input.** OAuth `client_secret` and API keys collected through a local browser form.
|
|
|
|
**`{base_url}` templating.** Multi-tenant providers (GitHub Enterprise, Okta, GitLab self-managed).
|
|
|
|
**Audit logging.** Structured JSON event log for login, logout, revoke, and export.
|
|
|
|
**Admin audit dashboard** and **Notion DCR** provider.
|
|
|
|
**`AUTHSOME_HOME`** for per-project credential isolation.
|
|
</Update>
|
|
|
|
<Update label="0.1.x" description="up to 2026-04-24">
|
|
Initial public series. Established the CLI surface, four flow types (PKCE, device code, DCR + PKCE, API key), bundled providers, and the proxy runner.
|
|
</Update>
|
|
|
|
## Versioning
|
|
|
|
Authsome follows [Semantic Versioning](https://semver.org). The current series is `0.x`, so breaking changes can happen on minor bumps and are called out under `### ⚠ BREAKING CHANGES` in [CHANGELOG.md](https://github.com/agentrhq/authsome/blob/main/CHANGELOG.md). Once the `1.0` line lands, breaking changes will be confined to major bumps.
|
|
|
|
## Upgrading
|
|
|
|
Authsome is installed as a regular Python package:
|
|
|
|
```bash
|
|
# uv tool (recommended)
|
|
uv tool upgrade authsome
|
|
|
|
# pip
|
|
pip install --upgrade authsome
|
|
|
|
# uvx (one-off, no install)
|
|
uvx authsome@latest --version
|
|
```
|
|
|
|
Stored credentials, providers, and client config persist across upgrades. Connection records carry a `schema_version` field reserved for forward-compatibility migrations.
|
|
|
|
## What's next
|
|
|
|
<Columns cols={2}>
|
|
<Card title="Roadmap" icon="map" href="/roadmap">
|
|
What's coming and what's deliberately out of scope.
|
|
</Card>
|
|
<Card title="Installation" icon="download" href="/installation">
|
|
Install paths and upgrade commands.
|
|
</Card>
|
|
</Columns>
|