Human Auth Oauth
Apps & Automationhuman-auth-oauthHuman Auth Oauth is an Agent Skill for apps & automation published in the pockebot/openpocket repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Handle account login credential delegation from Human Phone. Covers username/password entry, social sign-in walls, and multi-step login flows.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/pockebot/openpocket/blob/HEAD/skills/human-auth-oauth/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/human-auth-oauth, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Human Auth: OAuth / Login
Use this when an app requires the user to log in with their account credentials.
When to Trigger
- App shows a login screen with username/email and password fields.
- App redirects to a social sign-in page (Google, Apple, Facebook, etc.).
- App requires account authentication to proceed.
How to Call
request_human_auth(
capability: "oauth",
instruction: "Please provide your login credentials for [app/service name].",
uiTemplate: {
fields: [
{ id: "username", label: "Username / Email", type: "text", required: true, autocomplete: "username" },
{ id: "password", label: "Password", type: "password", required: true, autocomplete: "current-password" }
],
artifactKind: "credentials",
requireArtifactOnApprove: true,
title: "Account Login Required",
summary: "Enter your credentials to log in."
}
)
After You Receive the Artifact
-
Read the artifact:
read(<artifact_path>)to getusernameandpassword. -
Check the current screen. The login form may still be visible, or the app may have changed state during the wait.
-
If the login form is still visible:
- Tap the username/email field →
type_text(<username>) - Tap the password field →
type_text(<password>) - Tap Sign In / Log In / Submit
- Tap the username/email field →
-
If the screen changed: press
keyevent KEYCODE_BACKto return to the login form, or re-navigate to it. -
Delete the artifact immediately (contains plaintext credentials):
exec("rm <artifact_path>") -
Handle post-login flows (2FA prompt, terms acceptance, etc.) as needed.
Multi-Step Login (e.g., Google)
Some services split login into two pages (email first, then password). If the login screen only shows one field:
- Type the visible field's value, tap Next.
- On the next page, call
request_human_authagain for the password if needed, or use the already-received credentials.
Tips
- If the app has "Sign in with Google/Apple" button, consider Remote Takeover so the human can complete the OAuth flow directly.
- Never type credentials into the wrong field. Always verify the field label before typing.