Skip to content

QBe1n/relocation-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

╔═══════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                       ║
║      ██████╗ ███████╗██╗      ██████╗  ██████╗ █████╗ ████████╗ ██████╗ ██████╗       ║
║      ██╔══██╗██╔════╝██║     ██╔═══██╗██╔════╝██╔══██╗╚══██╔══╝██╔═══██╗██╔══██╗      ║
║      ██████╔╝█████╗  ██║     ██║   ██║██║     ███████║   ██║   ██║   ██║██████╔╝      ║
║      ██╔══██╗██╔══╝  ██║     ██║   ██║██║     ██╔══██║   ██║   ██║   ██║██╔══██╗      ║
║      ██║  ██║███████╗███████╗╚██████╔╝╚██████╗██║  ██║   ██║   ╚██████╔╝██║  ██║      ║
║      ╚═╝  ╚═╝╚══════╝╚══════╝ ╚═════╝  ╚═════╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝      ║
║                                                                                       ║
║                         End-to-End Personal Relocation Agent                          ║
║                           Perplexity Computer Skill - v1.0                            ║
║                                                                                       ║
║                                       By QBe1n                                        ║
║                                                                                       ║
╚═══════════════════════════════════════════════════════════════════════════════════════╝

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣴⣶⣾⣿⣿⣿⣶⣶⣤⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⣠⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣄⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⡿⠋⠁⠀⠈⠙⢿⣿⣿⣿⣿⣿⣷⡀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⡿⠋⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⣿⡄⠀⠀⠀⠀⠀
⠀⠀⠀⠀⢠⣿⣿⣿⣿⡿⠋⠀⠀⠀⠀⣠⣤⡀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⡄⠀⠀⠀⠀
⠀⠀⠀⢀⣿⣿⣿⣿⠏⠀⠀⠀⠀⣠⣾⣿⣿⣷⣄⠀⠀⠀⠀⠀⠹⣿⣿⣿⣿⡀⠀⠀⠀
⠀⠀⠀⣸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣇⠀⠀⠀
⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀ Pack your life.....
⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⡏⠉⠉⠉⠉⣿⣿⠉⠉⠉⠉⢹⣿⣿⣿⣿⣿⣿⣿⣿⠀ Move anywhere.
⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠀⠀⣿⣿⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀
⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠀⠀⣿⣿⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀
⠀⠀⠀⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠀⠀⠀

RELOCATOR - End-to-End Personal Relocation Agent for Perplexity Computer

Author: QBe1n (@QBe1n)

License: MIT (see LICENSE file)

Repository: https://github.com/QBe1n/relocation-agent

Platform: Perplexity Computer Agent Skill


What is RELOCATOR?

RELOCATOR is a full-service personal relocation agent built as a Perplexity Computer skill. It manages an entire residential move end-to-end — from apartment hunting to settling into your new place — so you can focus on your life instead of spreadsheets and browser tabs.

Drop it into your Perplexity Computer skills library, tell it where you're moving, and it takes over.

RELOCATOR autonomously:

  1. Profiles your move — budget, unit specs, deal-breakers, lifestyle priorities, commute anchors
  2. Researches neighborhoods with weighted scoring across safety, walkability, cost, amenities, internet, transit
  3. Searches apartment listings on local platforms (sahibinden, Bayut, Zillow, Idealista — adapts to market)
  4. Compares leases side-by-side with red-flag analysis and negotiation suggestions
  5. Calculates total first-year cost — rent, deposits, agency fees, utilities, maintenance
  6. Collects mover quotes with ratings, services, and availability comparison
  7. Documents your move with a room-by-room photo checklist (before/after) for deposit protection
  8. Builds a day-by-day moving timeline from T-30 to T+7
  9. Tracks utility setup — providers, plans, pricing, activation status
  10. Manages address changes across 100+ services — banks, crypto exchanges, government, subscriptions
  11. Maintains a living dashboard updated after every action
  12. Adapts to local markets — Dubai post-dated cheques, Turkish ikamet rules, UK deposit schemes, US state laws

Disclaimer: It's a vibe-coded moving concierge, and we can't live without it: RELOCATOR was built because moving sucks and spreadsheets suck harder. It's held together by structured prompts and aggressive parallelism. Consider it an early release — but it already handles real moves (tested on a Dubai → Antalya relocation). Your mileage may vary. Literally.


What's unique about RELOCATOR?

  • Market-aware intelligence — Doesn't just search listings. Understands that Dubai requires Ejari registration, Turkey has ikamet residency restrictions, and London has tenant fee bans. Adapts its workflow per jurisdiction.
  • Weighted neighborhood scoring — Safety, walkability, internet speed, commute time, amenities, and vibe — all scored and weighted to YOUR priorities, not some generic "best neighborhood" list.
  • Lease red-flag engine — Scans contracts for excessive fees, one-sided termination clauses, auto-renewal traps, and vague maintenance language. Provides exact negotiation counter-language.
  • Photo documentation system — Room-by-room checklist with metadata (meter readings, timestamps, witness info) that protects your deposit. Generates the checklist, you shoot the photos.
  • Address change tracker — 100+ services organized by urgency tier, including crypto exchange KYC updates, cloud provider billing, domain registrar WHOIS, and jurisdiction-specific items.
  • Living dashboard — One file that shows you exactly where your move stands at any moment.

Recent improvements

  • v1.0 — Initial release with full 6-phase pipeline, bundled reference docs (lease red flags, photo guide, address change master list), multi-market support

Quick Start

# 1. Download the skill
git clone https://github.com/QBe1n/relocation-agent.git

# 2. Option A: Install via Perplexity Computer UI
#    Go to https://www.perplexity.ai/computer/skills
#    Upload the relocation-agent.zip or SKILL.md

# 3. Option B: Drop into your skills directory manually
#    Copy the relocation-agent/ folder to your Perplexity Computer skills

# 4. Activate in any conversation
#    Just say: "I'm moving to [city]"
#    or: "activate relocation agent for [city]"

Phases

Phase 1: Requirements Intake      — Budget, specs, deal-breakers, lifestyle priorities
Phase 2: Neighborhood Research    — Scored comparison of 3-6 candidate areas
Phase 3: Apartment Search         — Shortlist of 5-10 apartments ranked by value
Phase 4: Lease Comparison         — Side-by-side terms + red-flag analysis
Phase 5: Move Logistics           — Mover quotes, photo docs, day-by-day timeline
Phase 6: Post-Move Setup          — Utilities, address changes, internet research

Each phase runs independently. Skip, reorder, or run them in parallel.


Architecture

  • SKILL.md — Core agent instructions (~400 lines), 6-phase pipeline definition, behavioral guidelines, tool routing
    • Phase 1: Structured intake via ask_user_question
    • Phase 2: Parallel neighborhood research via wide_research / run_subagent
    • Phase 3: Listing extraction via browser_task / wide_browse
    • Phase 4: Document analysis via read + red-flag matching against reference guide
    • Phase 5: Mover research + template generation
    • Phase 6: Tracker generation from master lists
  • references/ — Bundled knowledge base
    • lease-red-flags.md — 10 flags with severity, market norms, negotiation language, jurisdiction notes (UAE, US, UK, HK)
    • photo-documentation-guide.md — Room-by-room shot list, metadata template, damage dispute prevention
    • address-change-master-list.md — 100+ services in 3 urgency tiers, tech/crypto-specific, international move additions

See: SKILL.md for full implementation details.


Supported Markets

Market Platforms Local Knowledge Status
Turkey sahibinden, hepsiemlak, emlakjet ikamet rules, DEWA-equivalent, TRY budgeting ✅ Tested
UAE / Dubai Bayut, Property Finder, Dubizzle Ejari, DEWA, post-dated cheques, RERA index ✅ Built-in
United States Zillow, Apartments.com, Redfin State-level tenant law, Fair Housing Act ✅ Built-in
United Kingdom Rightmove, Zoopla, OpenRent Tenant Fees Act, deposit schemes, EPC ratings ✅ Built-in
Hong Kong 28Hse, Spacious, Midland Stamp duty, government rates, agent fee norms ✅ Built-in
Spain Idealista, Fotocasa, pisos.com NIE requirements, fianza rules ⚠️ Partial
Other Auto-detected Generic lease analysis + address tracking ⚠️ Partial

Environment Variables

No environment variables required. The skill runs entirely within Perplexity Computer's runtime and uses its built-in tool suite (web search, browser automation, file management, connected apps).

Optional integrations if connected:

  • Google Calendar — Schedule viewings and mover appointments
  • Google Drive — Store lease documents and photos
  • Notion — Sync dashboard and trackers

File Structure

relocation-agent/
├── SKILL.md                              # Core agent instructions
└── references/
    ├── lease-red-flags.md                # Lease analysis reference (UAE, US, UK, HK)
    ├── photo-documentation-guide.md      # Room-by-room photo checklist
    └── address-change-master-list.md     # 100+ services, 3 urgency tiers

At runtime, the agent creates a workspace:

relocation/
├── profile.json                          # Your requirements
├── dashboard.md                          # Living status dashboard
├── neighborhoods/
│   ├── {name}.md                         # Per-neighborhood reports
│   └── comparison.csv                    # Scored comparison matrix
├── apartments/
│   ├── shortlist.csv                     # Ranked apartment list
│   └── {id}.json                         # Individual listing data
├── leases/
│   └── comparison.md                     # Side-by-side lease analysis
├── movers/
│   ├── quotes/                           # Mover company comparisons
│   ├── timeline.md                       # Day-by-day moving plan
│   └── photos/
│       ├── before/                       # Pre-move documentation
│       ├── after/                        # Post-move documentation
│       └── checklist.md                  # Room-by-room shot list
├── utilities/
│   └── tracker.md                        # Utility setup status
└── address-changes/
    └── tracker.md                        # Address update status

Contribute

This is an open skill — PRs welcome. Some ideas:

  • Add market support for Germany (Immobilienscout24, WG-Gesucht, Anmeldung workflow)
  • Add market support for Portugal (golden visa implications, NHR tax regime)
  • Your idea here
  • Your second idea here

Build a new market module, improve the lease analysis, or add a phase we haven't thought of.


License

MIT License - Copyright (c) 2026 QBe1n

See LICENSE file for full text.


Support

About

End-to-end personal relocation agent — Perplexity Computer skill. Apartment search, lease comparison, utility setup, address changes, mover quotes, neighborhood research.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors