aside-password-manager

Password Manager

Aside Password Manager is a native credential manager the agent can use without seeing generated passwords. Use passwordManager in the REPL to autofill logins, payment cards, and identities, create signup password refs, search saved credential sites, and store credentials.

Before using Aside Password Manager as the website login source, check memory/USER.md for connected external password manager preferences. If the user configured one or more external providers, try a connected provider first and use Aside Password Manager to unlock that provider or as the fallback. If no connected external provider preference is present, use Aside Password Manager as the default login/autofill source.

Use Cases

1. Check websites the user is using

When searching for task-relevant information, saved credential sites are useful hints about services the user already uses. It never exposes the secret values so it's safe to use for searching.

const keywords = ['search 1', 'search 2', 'search 3'];
const vaults = await passwordManager.listVaults();
// vaults: [{ vaultId, name }, ...]
const results = await Promise.all(keywords.map(k => passwordManager.listItems({ text: k })));
// results: [[{ title, urls, category, username, oauth, primaryHost, vaultId, itemId }, ...], ...]

Use these results to find relevant sites the user already uses.

2. Autofill a selected item

When you are on a login page, search login candidates with listItems(...), then use autofillItem(page, itemId) only after selecting a clearly matching item. listItems(...) may return multiple candidates. Choose by site, title, username/OAuth account, URLs, and task context. Ask only when the right account is genuinely ambiguous - last resort! If Aside has no usable login, continue normal page inspection. Users may have other password managers (e.g. 1Password), and focusing a field may reveal their autofill UI.

const candidates = await passwordManager.listItems({ text: 'example.com', category: 'login' });
console.log(candidates);

// If one candidate clearly matches the user's task, use it and continue browsing.
await passwordManager.autofillItem(page, '<selected-item-id>');