signaloid-cli repos connect

Connect a new GitHub repository to Signaloid.

Synopsis

signaloid-cli repos connect --url <gitUrl> [options]

Options

Option	Required	Description	Default
--url <gitUrl>	Yes	Remote Git repository URL	-
--commit <sha>	No	Git commit hash or ref	HEAD
--branch <name>	No	Git branch name	main
--dir <path>	No	Build directory path	src
--args <args>	No	Default runtime arguments	""
--core-id <coreId>	No	Signaloid Core ID	-

Description

Connects a GitHub repository to your Signaloid account, allowing you to create builds from the repository's code. You can specify the branch, commit, build directory, and other configuration options during connection. The repository must be accessible to your Signaloid account.

Examples

Connect a repository with defaults:

signaloid-cli repos connect \
  --url https://github.com/signaloid/Signaloid-Demo-C-Template

Connect with custom settings:

signaloid-cli repos connect \
  --url https://github.com/user/project \
  --branch develop \
  --dir src/main \
  --args "--enable-uncertainty" \
  --core-id cor_e7eec4dce06f5a03a1b5418e0c5cbd7e # C0Pro-S+

Connect a specific commit:

signaloid-cli repos connect \
  --url https://github.com/user/project \
  --commit a1b2c3d4e5f6

Notes

• The repository must be accessible to your Signaloid account
• For private repositories, ensure your GitHub account is connected to Signaloid
• URL validation is performed before attempting to connect
• Invalid URLs will be rejected with a clear error message

Troubleshooting

"Invalid repository URL" Error

Problem: Repository connection fails with invalid URL error.

Solutions:

1. Ensure URL is properly formatted: https://github.com/user/repo
2. Check for typos in the URL
3. Verify the repository exists and is accessible
4. Don't include .git suffix (it's optional)

"Repository not accessible" Error

Problem: Can't access private repository.

Solutions:

1. Connect your GitHub account to Signaloid
2. Verify you have access to the repository on GitHub
3. Check if the repository is private and permissions are correct
4. Re-authorize Signaloid's GitHub integration

"Build directory not found" Error

Problem: Specified build directory doesn't exist in repository.

Solutions:

1. Verify the directory path is correct
2. Check the default branch has the directory
3. Use --dir flag to specify correct path
4. List repository contents on GitHub to confirm structure

See Also

• signaloid-cli repos update - Update repository settings
• signaloid-cli repos disconnect - Disconnect a connected repository
• signaloid-cli repos list - List all connected repositories
• signaloid-cli repos - Repository management overview