Skip to main content

profile

Manage investment profiles for different scenarios and markets.

Usage

mortgage-cli profile <COMMAND> [OPTIONS]

Commands

CommandDescription
listList all available profiles
showDisplay details of a specific profile
createCreate a new profile
deleteDelete a profile
compareCompare analysis across multiple profiles

profile list

List all available profiles.

mortgage-cli profile list [OPTIONS]

Options

OptionShortTypeDefaultDescription
--output-oTEXTtableOutput format: table, json

Example

mortgage-cli profile list
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Name ┃ Description ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ default │ Default French rental investment profile│
│ conservative │ Conservative estimates with buffer │
│ paris │ Paris property market parameters │
└───────────────┴─────────────────────────────────────────┘

profile show

Display all settings for a profile.

mortgage-cli profile show <NAME>

Arguments

ArgumentDescription
NAMEProfile name to display

Example

mortgage-cli profile show default
Profile: default
Description: Default French rental investment profile

Mortgage Terms
Interest Rate: 4.0%
Insurance Rate: 0.40%
Duration: 20 years
Default Down Payment: 20%

Budget
Total Available: €50,000
Target Rent: €1,000/month

Monthly Costs
Property Tax: €100
Insurance: €30
Maintenance: €50
Management: €0
Total: €180/month

Purchase Costs
Notary/Legal: 1.5% of price
Bank Arrangement: 1.0% of price
Survey/Valuation: €750

Thresholds
Green Below: 90% of target
Yellow Below: 100% of target

profile create

Create a new profile by copying from an existing one.

mortgage-cli profile create <NAME> [OPTIONS]

Arguments

ArgumentDescription
NAMEName for the new profile

Options

OptionShortTypeDefaultDescription
--description-dTEXTProfile description
--base-bTEXTdefaultProfile to copy settings from

Example

mortgage-cli profile create conservative --description "Conservative estimates" --base default
Created profile 'conservative' based on 'default'
Edit with: mortgage-cli profile edit conservative

Editing Profiles

Profiles are stored as YAML files in ~/.config/mortgage-cli/profiles/. To customize a profile, edit the YAML file directly:

# macOS/Linux
nano ~/.config/mortgage-cli/profiles/conservative.yaml

# Or use your preferred editor
code ~/.config/mortgage-cli/profiles/conservative.yaml

profile delete

Delete a profile.

mortgage-cli profile delete <NAME> [OPTIONS]

Arguments

ArgumentDescription
NAMEProfile name to delete

Options

OptionShortTypeDefaultDescription
--force-fFLAGSkip confirmation prompt

Example

mortgage-cli profile delete old-profile
Delete profile 'old-profile'? [y/N]: y
Deleted profile 'old-profile'
note

The built-in default profile cannot be deleted.


profile compare

Compare analysis results across multiple profiles for the same property.

mortgage-cli profile compare [OPTIONS]

Options

OptionShortTypeDefaultDescription
--price-pFLOATrequiredProperty purchase price
--rent-rFLOATrequiredExpected monthly rent
--profilesTEXTrequiredComma-separated profile names
--output-oTEXTtableOutput format: table, json

Example

mortgage-cli profile compare --price 150000 --rent 900 --profiles default,conservative,optimistic
Profile Comparison - €150,000 @ €900/month
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Profile ┃ Break-even Rent ┃ Cash-on-Cash ┃ Verdict ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ optimistic │ €820/month │ 2.8% │ GREEN │
│ default │ €885/month │ 0.5% │ GREEN │
│ conservative │ €950/month │ -1.5% │ YELLOW │
└───────────────┴─────────────────┴───────────────┴──────────┘

Use Cases

  1. Risk Assessment: Compare optimistic vs conservative assumptions
  2. Market Comparison: Use different profiles for different cities
  3. Scenario Planning: Test different interest rate environments