Frequently Asked Questions
What can CodeScene do for me?
CodeScene is a service for behavioral code analysis and the tool supports all analyses in Your Code As A Crime Scene. Use CodeScene to prioritize refactorings and technical debt in your codebase.
Since CodeScene takes a behavioral view of of your codebase, you're also able to get insights into the people side of your code. This means that you can detect coordination bottlenecks, simulate upcoming knowledge loss used for off-boarding, and measure how well your organization aligns with Conway's Law.
The main data source is your version-control history on GitHub. If you don't use GitHub you want to checkout our feature-complete on-premise CodeScene.
Do you support private repositories?
Yes, we do. Check out our plans for details on private GitHub repositories.
We have sensitive data -- what's your take on privacy?
We never share data in private repositories. CodeScene does fetch your repository to do an analysis and deletes the local copy immediately afterwards. The analysis results are only available to you and the people you chose to invite. You can also delete an analysis project at any time and we make sure all your data is removed.
Our detailed general conditions are available here (PDF).
Can I analyze repositories owned by an organization?
Yes, all plans let you analyze repositories owned by organizations that you are a member of. However, with the free plan you can only analyze public organizational repositories.
Can I analyze codebases that are split across multiple Git repositories?
Yes, CodeScene supports multi-repository analyses.
I've heard about Empear's X-Ray analysis; Can I have that one?
X-Ray is an analysis that investigates the evolution of each function or method within a Hotspot. X-Ray is a great tool to prioritize technical debt and lets you refactor large files iteratively guided by data as described here and here.
CodeScene supports X-Ray for Hotspots. Just click on a Hotspot in your Hotspot Map and launch an X-Ray. We'll add support for X-Ray in our temporal coupling analysis soon.
How does CodeScene help me measure organizational aspects like Conway's Law?
CodeScene lets you build knowledge maps over your code and measure the potential knowledge loss in your codebase (aka the Bus factor). You can also analyze the development efforts across teams. That team-level measurement lets you inspect how well-aligned your organization and architecture are with respect to Conway's Law. All you have to do is to visit your project's configuration page and define the teams in your organization.
Will you support Bitbucket and GitLab too?
Yes, we will. However we start with GitHub and then add support for other Git hosting services.
Is there any integration via webhooks?
That's something we plan to add too. CodeScene will grow into a service where your analyses are triggered automatically as you push code to your Git repositories. Of course the analysis results will be published back to you. You can even chose to integrate the analysis results into your existing work pipeline such as code reviews and risk management.
We'll tell you more about the possible integrations once we've implemented full support for them. Our plan is to make it as simple as possible for you while still leaving you in control of your data.
Can I use CodeScene even though we host our own Git repositories?
Sure, please check out our on-premise version of CodeScene. It's a feature complete product capable of analyzing large-scale, multiple repository codebases.
Plans & Pricing
Is CodeScene free as in beer?
CodeScene will always be free for open source projects. We also have a set of pricing plans so that you can tailor CodeScene to your needs. Our goal is to make CodeScene as cheap as a beer for small projects and charge a bit more for organizations in need of more heavy analyses.
Security & Access
Why do you request write access to GitHub repositories?
Because of how the GitHub API works, we are forced to request read and write access for CodeScene in order to read your code (see repo and public_repo scopes). However, we never write any data to your Git repositories. In the future we plan to do integration with GitHub to automatically post comments and code reviews, but that will not touch the Git repository itself.
Can projects be shared across multiple accounts?Yes, we have two ways how to share projects with other CodeScene users.
Organizational accounts are the primary way to share multiple projects with other members of your GitHub organization. When you create a new organizational account you can add/remove organization members in Configuration.
Organization members have access to all projects inside your organization. You can also give a collaborator access to a single project in the "Access Management" section in project configuration using the corresponding email addresses of those accounts. To find the email address, check the "My Account" page of the collaborator.
As a collaborator, you get read access to a project and its analysis results, as well as the ability to run new analyses, and to X-Ray files.
What's your take on security and vulnerabilities?
We work actively to ensure the privacy of your data and information. We also appreciate your help with disclosing security vulnerabilities, and we offer a reward to the first person that reports a vulnerability.
Read more in our Responsible Disclosure Policy.