Skip to content

feat: remote + local CLI support...#125

Merged
bmdavis419 merged 2 commits intomainfrom
davis/better-onboarding
Jan 27, 2026
Merged

feat: remote + local CLI support...#125
bmdavis419 merged 2 commits intomainfrom
davis/better-onboarding

Conversation

@bmdavis419
Copy link
Collaborator

@bmdavis419 bmdavis419 commented Jan 26, 2026

plan

onboarding stuff started

Greptile Overview

Greptile Summary

This PR refactors btca init to offer two setup paths (MCP cloud vs CLI local), and adds a new btca add command for interactively adding GitHub resources.

Key Changes:

  • Replaced btca init --local flag with interactive prompt choosing between MCP or CLI setup
  • Added new btca add <github-url> command with interactive wizard
  • Updated AGENTS.md with Better Context MCP instructions
  • Added INIT_MCP_CLI_REFACTOR_PLAN.md plan file

Critical Issues:

  • Breaking change: Removed --local flag from btca init that was documented in CHANGELOG.md. Users expecting btca init --local will get errors. The flag was replaced with an interactive prompt.
  • Invalid schema URL: Changed from https://btca.dev/btca.schema.json to https://btca.schema.json (missing domain) in apps/cli/src/commands/init.ts:7, which will cause config validation to fail.
  • Plan file in repo: INIT_MCP_CLI_REFACTOR_PLAN.md should be removed before merging.

Confidence Score: 2/5

  • This PR has breaking changes and a critical bug that will prevent the config from working properly
  • The removal of --local flag breaks existing functionality documented in CHANGELOG.md, and the invalid schema URL will cause config validation issues
  • Pay close attention to apps/cli/src/commands/init.ts - it has a critical schema URL bug and breaking changes

Important Files Changed

Filename Overview
INIT_MCP_CLI_REFACTOR_PLAN.md Plan file added documenting the CLI refactor design - should be removed before merge
apps/cli/src/commands/init.ts Refactored to support MCP/CLI setup paths, but has breaking changes and schema URL bug
apps/cli/src/commands/add.ts New command for adding GitHub resources with interactive wizard

@bmdavis419 bmdavis419 changed the title plan feat: remote + local CLI support... Jan 26, 2026
Copy link
Collaborator Author

bmdavis419 commented Jan 26, 2026

@bmdavis419 bmdavis419 marked this pull request as ready for review January 26, 2026 07:16
@bmdavis419 bmdavis419 mentioned this pull request Jan 26, 2026
Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

2 files reviewed, 2 comments

Edit Code Review Agent Settings | Greptile


const PROJECT_CONFIG_FILENAME = 'btca.config.jsonc';
const CONFIG_SCHEMA_URL = 'https://btca.dev/btca.schema.json';
const CONFIG_SCHEMA_URL = 'https://btca.schema.json';
Copy link
Contributor

Choose a reason for hiding this comment

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

Schema URL is incorrect - missing domain.

Suggested change
const CONFIG_SCHEMA_URL = 'https://btca.schema.json';
const CONFIG_SCHEMA_URL = 'https://btca.dev/btca.schema.json';
Prompt To Fix With AI
This is a comment left during a code review.
Path: apps/cli/src/commands/init.ts
Line: 7:7

Comment:
Schema URL is incorrect - missing domain.

```suggestion
const CONFIG_SCHEMA_URL = 'https://btca.dev/btca.schema.json';
```

How can I resolve this? If you propose a fix, please make it concise.

Comment on lines 226 to 228
export const initCommand = new Command('init')
.description('Initialize a btca project configuration')
.option('-l, --local', 'Use local .btca directory for data storage')
.description('Initialize btca for this project')
.option('-f, --force', 'Overwrite existing configuration')
Copy link
Contributor

Choose a reason for hiding this comment

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

Breaking change: removed --local flag documented in CHANGELOG.md. Users expecting btca init --local will get errors.

Prompt To Fix With AI
This is a comment left during a code review.
Path: apps/cli/src/commands/init.ts
Line: 226:228

Comment:
Breaking change: removed `--local` flag documented in CHANGELOG.md. Users expecting `btca init --local` will get errors.

How can I resolve this? If you propose a fix, please make it concise.

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

2 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile


const PROJECT_CONFIG_FILENAME = 'btca.config.jsonc';
const CONFIG_SCHEMA_URL = 'https://btca.dev/btca.schema.json';
const CONFIG_SCHEMA_URL = 'https://btca.schema.json';
Copy link
Contributor

Choose a reason for hiding this comment

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

Schema URL is invalid - missing domain. Should be https://btca.dev/btca.schema.json (as it was before and as shown in btca.config.jsonc:2).

Prompt To Fix With AI
This is a comment left during a code review.
Path: apps/cli/src/commands/init.ts
Line: 7:7

Comment:
Schema URL is invalid - missing domain. Should be `https://btca.dev/btca.schema.json` (as it was before and as shown in `btca.config.jsonc:2`).

How can I resolve this? If you propose a fix, please make it concise.

Copy link
Collaborator Author

bmdavis419 commented Jan 27, 2026

Merge activity

  • Jan 27, 9:55 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Jan 27, 9:55 PM UTC: @bmdavis419 merged this pull request with Graphite.

@bmdavis419 bmdavis419 merged commit 2cc43ed into main Jan 27, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant