authsome
Use this to access external services/CLIs/APIs: Gmail/gh/Github/Stripe etc. or when running any bash command, script, or curl/wget that makes outbound HTTP calls. Make HTTP requests directly and the gateway injects credentials automatically.
Security Assessment
About authsome
Authsome is an AI skill designed to simplify authenticated access to external services, APIs, and command-line tools through a transparent HTTPS proxy layer. It enables outbound HTTP requests to services such as Gmail, GitHub, Stripe, Google Calendar, and other OAuth or API-key-based platforms without exposing or manually handling credentials. By routing traffic through the Authsome gateway, the skill automatically injects stored authentication headers into requests, allowing agents and scripts to interact with external systems securely and consistently. This approach reduces the complexity of managing tokens, secrets, and environment configuration while maintaining a streamlined workflow for automated tasks and API integrations.
The skill supports running authenticated commands through a simple wrapper pattern using `authsome run -- <command>`. Standard HTTP clients and developer tools such as curl, Python requests, axios, Go net/http, git, and fetch are supported because they automatically honor the configured HTTPS proxy environment. Authsome also includes login and provider management workflows for OAuth-based services, allowing providers to be connected, revoked, re-authenticated, or extended with additional scopes when required. Troubleshooting guidance and built-in CLI help commands are included to reduce incorrect command usage and improve reliability during authentication or connectivity failures.
Authsome is useful for developers, AI agents, automation systems, and technical operators who need secure programmatic access to external services without manually managing API keys or browser-based authentication flows. Common use cases include executing authenticated API requests, running scripts that depend on external services, integrating with developer platforms such as GitHub, and automating workflows that require OAuth-backed access. It is particularly valuable in environments where secure credential handling and simplified external connectivity are important.
FAQ
How do I make authenticated API requests with Authsome?
Run commands using the `authsome run -- <command>` pattern. The gateway intercepts outbound HTTPS traffic and injects credentials automatically for connected providers.
Which tools and HTTP clients are compatible with Authsome?
Standard HTTP clients and developer tools that honor the `HTTPS_PROXY` environment variable are supported, including curl, fetch, requests, axios, Go net/http, and git.
What should I do if I receive a 401 or 403 authentication error?
Use `authsome provider list` to inspect provider connections. For expired credentials, revoke and re-login to the provider. For missing permissions or scopes, re-run the login command with the required `--scopes` option.
Can Authsome work with OAuth providers like GitHub or Gmail?
Yes. The skill supports OAuth-connected services such as GitHub, Gmail, Google Calendar, Google Drive, and other external APIs available through the gateway.
What happens if Authsome is not installed on the machine?
Install it using `uv tool install authsome`. If that fails, fallback options include `pipx install authsome` or using `uvx authsome@latest` for one-off execution.
Install authsome
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
manojbajaj95/authsome