Skip to content

Document HAPPIER_HOME_DIR and agent-safe auth handoff - #810

Open
leeroybrun wants to merge 1 commit into
devfrom
cursor/docs-mcp-auth-happier-home-0520
Open

Document HAPPIER_HOME_DIR and agent-safe auth handoff#810
leeroybrun wants to merge 1 commit into
devfrom
cursor/docs-mcp-auth-happier-home-0520

Conversation

@leeroybrun

@leeroybrun leeroybrun commented Oct 30, 2026 •
edited by blacksmith-sh Bot
Loading

Copy link
Copy Markdown
Collaborator

Documentation updates for external agents and MCP hosts.

Changes

happier-as-mcp-server.mdx

Add Advanced: Running a second account side-by-side section:

  • Document HAPPIER_HOME_DIR environment variable for isolating accounts/relays
  • Show MCP host configuration example with alternate home directory
  • State it's advanced, not default workflow

agent-setup.mdx

Add agent-safe auth handoff guidance:

  • When an agent is relaying setup for someone else's computer, give them the happier auth login command to run themselves
  • Don't show the one-time approval link in the agent's transcript

Why

  • External MCP agents asked how to run multiple Happier accounts simultaneously
  • Setup agents sometimes showed auth links in transcripts when helping with remote setup

Related

Part of maintainer-approved MCP/CLI docs for 0.2.17. Sibling v0.3 port PR to follow.

Open in Web Open in Cursor 

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need.

@cursoragent @leeroybrun
docs: document HAPPIER_HOME_DIR for side-by-side accounts and agent a…
8647cd1 
…uth handoff

- Add HAPPIER_HOME_DIR documentation in happier-as-mcp-server.mdx for running
  multiple accounts side-by-side via MCP (advanced use case)
- Add agent-safe auth handoff note to agent-setup.mdx: agents relaying setup
  should give the command to run, not show the one-time link

Refs #4

Co-authored-by: Leeroy Brun <leeroybrun@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Oct 30, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 51 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 8 included reviews currently available.

Learn how review limits work.

Review configuration:

Run configuration
Commits

Reviewing files that changed from the base of the PR and between a6f72a6 and 8647cd1.

Files selected for processing: 2
  • apps/docs/content/docs/extending/happier-as-mcp-server.mdx
  • apps/docs/content/docs/getting-started/agent-setup.mdx
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@greptile-apps

greptile-apps Bot commented Oct 30, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 4/5

[Low impact] The PR’s reach is limited to guidance in two published docs pages.

Add the Windows sign-in example before merging to satisfy the repository's platform requirement.

Findings

  1. P2 Windows sign-in example is missing ▶

Summary

Documents separate MCP accounts and a safer sign-in handoff.

  • MCP hosts can use a separate CLI home for another Happier account.
  • Remote setup agents give the person the sign-in command to run.

Review used source inspection. No build, tests, or live sign-in were run.

Reviews (1) · Last reviewed commit: "docs: document HAPPIER_HOME_DIR for side..." · Reviewed by Greptile

greptile-apps[bot]
greptile-apps Bot reviewed Oct 30, 2026
View reviewed changes
Comment thread apps/docs/content/docs/extending/happier-as-mcp-server.mdx
Comment on lines +109 to +111
```bash
HAPPIER_HOME_DIR=/Users/you/.happier-work happier auth login
```

@greptile-apps greptile-apps Bot Oct 30, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Windows sign-in example is missing

The new recipe uses HAPPIER_HOME_DIR=... happier auth login, which PowerShell cannot run. Windows readers cannot authenticate the alternate home as shown. The repository requires Windows, Linux, and macOS support and prohibits POSIX-only shell assumptions. Add a PowerShell example and tell readers to use the same absolute directory in their MCP configuration. This repository requirement must be satisfied before merging.

Context Used: AGENTS.md (source)

@leeroybrun leeroybrun mentioned this pull request Oct 30, 2026
Open

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer
@greptile-apps greptile-apps[bot] greptile-apps[bot] left review comments
Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@leeroybrun @cursoragent