diff --git a/dotfiles/agents/AGENTS.md b/dotfiles/agents/AGENTS.md index 704a9958..de33bf56 100644 --- a/dotfiles/agents/AGENTS.md +++ b/dotfiles/agents/AGENTS.md @@ -46,14 +46,65 @@ nix search nixpkgs -## Credentials -- When a credential (password, API key, token, etc.) is needed to complete a task, use the `pass` utility to retrieve it. -- The pass password store lives at `~/.password-store/`. -- Use `pass show ` to retrieve a secret, or `pass find ` to locate entries. -- Never write passwords or other credentials directly into version-controlled files in any repo (for example `dotfiles/claude/settings.local.json`). +## Personal Information + +- Full Legal Name: Ivan Anthony Malison +- Email: IvanMalison@gmail.com +- Country of Citizenship: United States of America +- Birthday: August 2, 1990 (1990-08-02) +- Address: 100 Broderick St APT 401, San Francisco, CA 94117, United States +- Employer: Railbird Inc. +- GitHub: colonelpanic8 +- Phone: 301-244-9534 +- Primary Credit Card: Chase-Reserve + +## Repository Overview + +This is an org-mode repository containing personal task management, calendars, habits, and project tracking files. It serves as the central hub for Ivan's personal organization. + +## Available MCP Tools + +### Chrome DevTools MCP +A browser automation MCP is available for interacting with web pages. Use it to: +- Navigate to websites and fill out forms +- Take screenshots and snapshots of pages +- Click elements, type text, and interact with web UIs +- Read page content and extract information +- Automate multi-step web workflows (booking, purchasing, form submission, etc.) + +### Gmail MCP +A Gmail MCP is available for email operations. Use it to: +- Search, read, and send emails +- Draft emails for review before sending +- Manage labels and filters +- Batch modify or clean up emails +- Download attachments + +## Credentials via `pass` + +Many credentials and personal details are stored in `pass` (the standard unix password manager). There are hundreds of entries covering a wide range of things, so always search before asking the user for information. Use `pass find ` to search and `pass show ` to retrieve values. + +Examples of what's stored: +- Personal documents - driver's license, passport number, etc. +- Credit/debit cards - card numbers, expiration, CVV for various cards +- Banking - account numbers, online banking logins +- Travel & loyalty - airline accounts, hotel programs, CLEAR, etc. +- Website logins - credentials for hundreds of services +- API keys & tokens - GitHub, various services + +- The store is regularly updated with new entries. Always do a dynamic lookup with `pass find` rather than assuming what's there. - Provide credentials to tools/config at runtime via environment variables or inline `pass` usage instead of committing them. - Never hardcode credentials or store them in plain text files. + +## Guidelines + +- When filling out forms or making purchases, pull personal info from this file and credentials from `pass` rather than asking the user to provide them. +- For web tasks, prefer using the Chrome DevTools MCP to automate interactions directly. +- For email tasks, prefer using the Gmail MCP over navigating to Gmail in the browser. +- If a task requires a credential not found in `pass`, ask the user rather than guessing. +- This repo's org files (gtd.org, calendar.org, habits.org, projects.org) contain task and scheduling data. The org-agenda-api skill/service can also be used to query agenda data programmatically. + ## Project links (local symlink index) - Paths in this section are relative to this file's directory (`dotfiles/agents/`). - Keep a local symlink index under `./project-links/` for projects that are frequently referenced. @@ -76,3 +127,4 @@ - `./project-guides/taffybar.md` - `./project-guides/railbird.md` - `./project-guides/org-emacs-packages.md` +